Skip to main content

Troubleshooting / FAQ

CORS with HTTP Basic Authentication​

ngrok's HTTP tunnels will work with CORS, but you cannot use ngrok's --basic-auth option. ngrok's HTTP tunnels allow you to specify basic authentication credentials to protect your tunnels. However, ngrok enforces this policy on all requests, including the preflight OPTIONS requests that are required by the CORS spec. In this case, your application must implement its own basic authentication.

Certificate Warnings​

There are certain configurations of ngrok which will result in certificate warnings. These usually happen when trying to use custom certificates with an ngrok domain. These can usually be solved by using a custom branded domain.

Does ngrok have an official Status page​

Yes, here is the official ngrok status page.

Can I change the port on the ngrok domain?​

ngrok does not allow users to change the public ports on any reserved Domain or TCP Address. HTTPS and TLS tunnels will use port 443, and TCP tunnels will use the port assigned to you when the tunnel is created.

Can I get a static IP address?​

ngrok does not require nor provide static IP addresses. When you run the ngrok agent, it will update automatically as your public IP address changes, and you do not need to restart the agent. We do offer reserved Domains and TCP Addresses with our paid plans.

What information is stored about my tunnels?​

Please see our Terms of Service and Data Processing Agreement for more information.

What's the deal with ngrok v1?​

The original open source ngrok agent 1.x is available on GitHub but is no longer developed, supported or maintained. The latest ngrok agent is available on our ngrok downloads page.

How do I pronounce ngrok?​

en-grok

How long has ngrok been around?​

The first prototype for ngrok was committed on March 20th, 2013.