logo

... ngrok.


Sometimes you need to give somebody a demo and this person cannot sit next to you. This can be a stakeholder or a fellow developer. In these situations there's a great tool you can use to create a tunnel to your laptop. It's called ngrok.


Episode Notes

The installation process can be found here.

Two things are important to highlight in this process.

Move the Binary

You probably want to move the downloaded application to a folder that is globally reachable. This means that either you move the file to the place where your system typically stores the binaries of command line applications (on my mac this is /usr/local/bin/ngrok) or that you adjust your bash_profile file to include the path of your app.

If most of the words that you've just read do not make any sense, don't worry. You can still run all the commands in this tutorial but you need to replace the standard ngrok command with something different.

Instead of typing;

ngrok http 8080

You'll need to type;

/path/to/ngrok http 8080

Authentication

You need to go to your profile on ngrok.com and grab your authentication token. This can be added to your app locally by typing.

ngrok authtoken <YOUR_AUTH_TOKEN>

This will create a local file that contains your password. On my mac this file was placed at /Users/<username>/.ngrok2/ngrok.yml. The command line app will use this file to identify you.


Feedback? See an issue? Feel free to mention it here.

If you want to be kept up to date, consider getting the newsletter.