How To Avoid Ngrok Warning Page
To avoid the Ngrok warning page (which usually appears when you share an ngrok URL and the visitor sees a “This site is using ngrok” splash or a warning about an insecure tunnel), here are some tips:
Why Does the Ngrok Warning Page Appear?
- Ngrok shows a warning or splash page on free or basic plans to indicate the link is a tunnel.
- It may show when the tunnel uses HTTP or when the target site lacks SSL.
- Paid plans offer more control over branding and custom domains.
How to Avoid the Ngrok Warning Page
1. Use Ngrok’s Paid Plan
- Paid plans allow custom domains and removal of ngrok branding/warning pages.
- You can use your own SSL certificate for secure tunnels.
2. Use HTTPS Tunnels
- Start ngrok with HTTPS enabled: nginxCopyEdit
ngrok http https://localhost:YOUR_PORT - Ensures end-to-end encryption, reducing security warnings.
3. Use a Custom Domain
- With paid plans, configure a custom domain pointing to your ngrok tunnel.
- Visitors won’t see ngrok branding or warnings.
4. Serve Proper SSL from Your App
- Make sure your local server serves HTTPS.
- Ngrok will then forward secure traffic, avoiding some warnings.
5. Avoid Sharing URLs with Parameters Triggering Warnings
- Sometimes certain query parameters or URLs cause warnings — keep URLs clean.
Summary
- The simplest way is upgrading to ngrok’s paid tier.
- Otherwise, using HTTPS tunnels and clean URLs helps reduce warnings.
- You cannot fully remove the warning page on the free tier.
