Frequently asked questions
Quick answers to the questions developers actually ask about ngsrv. If yours isn't here, email support@ngsrv.com.
What is ngsrv?
ngsrv is a developer tool for exposing local services on the public internet. It gives you a public HTTPS URL that forwards to a port on your machine, plus a declarative ngsrv.yml config for multi-tunnel setups, custom domains, and edge security policies.
Can I expose localhost with ngsrv?
Yes. Install the CLI, run
ngsrv token <YOUR_TOKEN> once, then ngsrv http <port>. See the full walkthrough.How do I expose localhost:3000?
Run
ngsrv http 3000. See the full walkthrough in How to expose localhost:3000 to the internet.How do I expose localhost:4200?
Run
ngsrv http 4200. For Angular CLI, also pass --disable-host-check to ng serve. See How to expose localhost:4200 for client previews.Can I test Stripe webhooks with ngsrv?
Yes. Run
ngsrv http 4242 --subdomain hooksand paste the resulting URL into Stripe's webhook endpoints page. See Test webhooks locally.Can I test GitHub webhooks locally with ngsrv?
Yes. The flow is identical to Stripe: run a tunnel on your handler's port and paste the ngsrv URL into the repo's Webhooks settings page.
Can I share a local website with a client?
Yes. Use a reserved subdomain or a custom domain so the URL stays stable, then send it to your client. See Share a local website with a client.
Does ngsrv work with Laravel?
Yes. ngsrv is an HTTP forwarder, so any framework that listens on a local port works. Run php artisan serve and then ngsrv http 8000.
Does ngsrv work with Angular?
Yes. Run ng serve (default port 4200) and then ngsrv http 4200. You may need to pass --disable-host-check to Angular CLI so it accepts the public hostname.
Does ngsrv work with Vite?
Yes. Run npm run dev (default port 5173) and then ngsrv http 5173. If Vite rejects the host, add the ngsrv hostname to server.allowedHosts in vite.config.ts.
Does ngsrv work with Next.js?
Yes. Run npm run dev (default port 3000) and then ngsrv http 3000. If Next.js rejects the host, add the ngsrv hostname to experimental.allowedDevOrigins in next.config.js.
Does ngsrv work with Docker?
Yes. Either run the ngsrv CLI on the host pointing at a port mapped from the container, or run ngsrv inside the container itself using the docker image (docker pull ngsrv/cli:latest). In Kubernetes the recommended pattern is the ngsrv sidecar with /healthz, /readyz, and /metrics.
Is ngsrv free?
Yes. The free tier includes one tunnel, 10GB bandwidth per month, 100k requests, one custom domain, and the basic security policies. See /pricing.
How is ngsrv different from ngrok?
See the full comparison in ngsrv vs ngrok.
How is ngsrv different from localtunnel?
See the full comparison in ngsrv vs localtunnel.