Introspected tunnels to localhost

“I want to securely expose a local web server to the internet and capture all traffic for detailed inspection and replay.”

Download Sign up

Overview

Demo your latest code

ngrok creates a tunnel from the public internet (http://subdomain.ngrok.com) to a port on your local machine. You can give this URL to anyone to allow them to try out a web site you're developing without doing any deployment.

Understand HTTP services

ngrok captures all traffic through the tunnel. It displays information about the HTTP traffic for your inspection. Raw request/response bytes, parsed headers and form data, JSON/XML syntax checking and more are included.

Replay Requests

Developing services which consume webhooks can be challenging if the hooks are labor-intensive to generate. Use ngrok's replay request feature to iterate quickly on a new feature without switching contexts to generate new requests.

Download and Installation

ngrok is easy to install. Download a single binary with zero run-time dependencies for any major platform. Unzip it and then run it from the command line.

Step 1: Download ngrok

More platforms
Mac OS X	Download
Windows	Download
Linux	Download
Linux/ARM	Download

Step 2: Unzip it

On Linux or OSX you can unzip ngrok from a terminal with the following command. On Windows, just double click ngrok.zip.

$ unzip /path/to/ngrok.zip

Step 3: Run it!

Read the Usage Guide for documentation on how to use ngrok. Try it out by running it from the command line:

$ ./ngrok -help

Pricing & Features

ngrok.com is a pay-what-you-want service offered with no signup required. These features are available to everyone, without signing up. Just download and run!

Secure On-Demand Tunnels

You'll be assigned a random subdomain on ngrok.com. You can access it with HTTP, or securely with HTTPS.

ngrok 80

Request Inspection

Use the web inspection interface when ngrok is running to inspect the HTTP requests over your tunnel. You can even replay them to make debugging easier!

http://localhost:4040

Signup Features

However, there are several additional features of ngrok.com's service that are only available after you sign up.

Custom Subdomains

Pick a custom subdomain so your app appears on https://myapp.ngrok.com instead of http://a1b2c3d4.ngrok.com

ngrok -subdomain myapp 80

Password Protection

Specify http auth credentials required to access your tunnel so only you can access it.

ngrok -httpauth "user:password" 80

TCP Tunneling

ngrok supports tunnelling at the TCP layer so you can expose any type of networked service to the internet.

ngrok -proto tcp 22

Multiple Simultaneous Tunnels

Run multiple tunnels simultaneously with a single ngrok client. Great for distributed systems development or exposing multiple clients sites at once.

ngrok start client1 client2 client3

Paid Features

Several additional features of ngrok.com's service are only available after you pay (any amount).

Tunnel your own domains

Run tunnels over your own domains (requires DNS changes, see the usage documentation).

ngrok -hostname "tunnel.yourdomain.com" 80

Reserved Subdomains

Reserve subdomains for your own usage so that they are always available and never provisioned to another user.

49156202 connections proxied to 1074007 tunnels

More ngrok metrics powered by Keen IO

ngrok is pretty much my favorite thing right now @EWDurbin

#ngrok is a dream for testing localhost with remote APIs! @davejlong

@inconshreveable No need to download the newest ngrok because... it updates itself! You are the best. @brent_noorda

ngrok, probably the best tool I have started to use for my webwork since firebug also great support @inconshreveable @Botto

holy crap. http://ngrok.com is awesome, this solves pretty much all local developer problems.@julianwachholz

ngrok: moved ~/bin already, the web inspector is gold @pedromelo

Holy crap! #ngrok. Tell everyone! The most useful thing ever! @paulcampbell_

so http://ngrok.com is basically the greatest thing ever. @philadams

ngrok is the most amazing thing @ws

Using ngrok last night...awesome! definitely must have tool! @junwatu

ngrok is making my life so much better. https://ngrok.com #devstuff briancantrell

Ngrok is one of the most awesome tools I have found. @JakCharlton

ngrok is insanely useful. Well done @inconshreveable. @dN0t

I've been using ngrok for tunnels to localhost, best app like this I've used. It just works. @tommoo

on an unrelated dev tools note, have you tried Ngrok? its changed my bloody life! @errkk

When I heard about #ngrok I thought it sounded great, but I didn't realise it would be so incredibly simple to use @steve_south

ngrok.com just saved the day. @rjohnthas

Impressed with ngrok, a nice "local tunnel" client and server. Open source and Windows-friendly. @jkarneges

So my custom/static localtunneling woes have been vanquished. Thanks ngrok! @adelamodwala

This is a MUST for all Web Developers!! Make your localhost reachable from Anywhere instantly @AxSaucedo

Really cool. Not only tunnels, also replay & inspection capability: ngrok @adriaan_pelzer

Ngrok is the software equivalent of Slash's guitar solo in "Sweet Child of Mine" @kevinwhinnery