Download & setup ngrok

Get started in just a few seconds.

download for Mac OS
more options

1    Unzip to install

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

2    connect your account

Running this command will add your authtoken to your ngrok.yml file. Connecting an account will list your open tunnels in the dashboard, give you longer tunnel timeouts, and more. Visit the dashboard to get your auth token.

./ngrok authtoken <your_auth_token>

Don’t have an account? Sign up

3    fire it up

Try running it from the command line:

./ngrok help

To start a HTTP tunnel on port 80, run this next:
Read the documentation to get more ideas on how to use ngrok.

./ngrok http 80