By | May 29, 2025

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: nginxCopyEditngrok 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.