Download & setup ngrok

Get started with ngrok in just a few seconds.

  1. Download ngrok

    First, download the ngrok client, a single binary with zero run-time dependencies.

  2. Unzip to install

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

    unzip /path/to/

    Most people like to keep ngrok in their primary user folder or set an alias for easy command-line access.

  3. 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 authtoken.

    ./ngrok authtoken <YOUR_AUTH_TOKEN>
  4. Fire it up

    Try it out by running it from the command line:

    ./ngrok help

    To start a HTTP tunnel on port 80, run this next:

    ./ngrok http 80

    Read the documentation to get more ideas on how to use ngrok.