Public URLs for exposing your local web server

What is it Used for?

In a nutshell: it allows you to create an HTTP tunnel (and other types of tunnels). In this mechanism, the client asks an HTTP proxy server to forward the TCP connection to the desired destination, meaning that you can expose your local web server through a public URL.

Such tunnels are useful to test webhooks in local for example.

How Does it Work?

You download and run a program on your machine and provide it the port of your web server.

It connects to the ngrok cloud service which accepts traffic on a public address and relays that traffic through to the ngrok process running on your machine and then on to the local address you specified.

Source: ngrok - How it works.


Start by following the installation guide:

As an example, here is how you would create a tunnel to a local server running on port 3000 with SSL:

./ngrok http -subdomain your-domain https://localhost:3000