HTTP Tunnels

Expose your local HTTP server to the internet with a public HTTPS URL

The ngsrv http command creates a secure tunnel to your local HTTP server.

ngsrv http <port>

Example:

ngsrv http 3000

Creates a tunnel to localhost:3000 and provides a public HTTPS URL

Flag	Description	Example
--domain, -d	Use a custom domain	-d myapp
--policy, -p	Apply security policy (can use multiple)	-p ngsrv_ips_ABC
--config, -c	Path to config file	-c ./ngsrv.yml
--force, -f	Force create (terminate existing tunnel)	-f
--list, -l	List active tunnels	-l
--no-tui	Disable interactive UI (use simple console output)	--no-tui
--trace	Enable verbose debug logging	--trace

ngsrv http 3000

Creates a tunnel with a random subdomain

ngsrv http 3000 --domain myapp

Uses myapp.tnl.ngsrv.com as the public URL

ngsrv http 3000 --policy ngsrv_ips_ABC123 --policy ngsrv_time_DEF456

Applies IP security and time-based access policies

ngsrv http 3000 --domain myapp --force

Terminates existing tunnel on 'myapp' domain and creates a new one

ngsrv http --config ./ngsrv.yml

Reads port, domain, and policies from configuration file

When you create an HTTP tunnel, NGSRV:

Local Dashboard

While your tunnel is running, visit http://localhost:4040 to see real-time request logs and analytics.

Test webhooks from services like Stripe, GitHub, or Twilio by providing your tunnel URL as the webhook endpoint.

Develop OAuth integrations with consistent callback URLs using custom domains.

Test your local web app on real mobile devices over HTTPS.

Share work-in-progress with clients without deploying to staging.

Your local server isn't running or isn't listening on the specified port. Start your application first, then create the tunnel.

Check if your firewall is blocking connections or if your local server only binds to 127.0.0.1 instead of 0.0.0.0.

Use --force flag to terminate the existing tunnel and create a new one, or choose a different domain.