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 upOverview
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
| Mac OS X | Download |
|---|---|
| Windows | Download |
| Linux | Download |
| Linux/ARM | Download |
| More platforms | |
| Mac OS X 32-bit | Download |
| Windows 64-bit | Download |
| Linux 64-bit | Download |
| FreeBSD 32-bit | Download |
| FreeBSD 64-bit | 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 80Request 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:4040Signup 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 80Password Protection
Specify http auth credentials required to access your tunnel so only you can access it.
ngrok -httpauth "user:password" 80TCP Tunneling
ngrok supports tunnelling at the TCP layer so you can expose any type of networked service to the internet.
ngrok -proto tcp 22Multiple 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 client3Paid 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" 80Reserved Subdomains
Reserve subdomains for your own usage so that they are always available and never provisioned to another user.
365105079 connections proxied to 10425195 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
Man, you rule the Internet. Ngrok is a great tool, very useful and stable. Few http and tcp tunnels run on my Raspberry PI server. merlinnot
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
https://ngrok.com/ This program is ABSOLUTELY BRILLIANT. @mattarnster
