Get started

Deploy a gateway and open a public URL for your local development server.

Turbotunnel forwards HTTP and WebSocket traffic from a public URL to an app running on your machine. The gateway runs in your Vercel account.

Prerequisites

Node.js 22 or newer
A Vercel account
The Vercel CLI, installed and logged in

Install the CLIs and authenticate with Vercel:

npm i -g turbotunnel vercel
vercel login

Deploy your gateway

Deploy the gateway to your Vercel account:

tt deploy

Turbotunnel creates a Vercel project, deploys the gateway, verifies its status endpoint, and saves the connection settings in ~/.turbotunnel/config.json.

Open a tunnel

Start your local app, then pass its port to tt http:

tt http 5173

. turbotunnel beta

  Public           https://ttdemo12-turbotunnel.vercel.app/
  Local            http://localhost:5173
  Relays           2 sockets

✓ Tunnel ready in 1.2s

  Press Ctrl-C to stop

The public URL works until you press Ctrl-C or the process exits.

Next, pick a use case, open a configured project with tt dev, or inspect running tunnels.

Use cases

Webhooks, protected previews, monorepos, agents, and more.

Deploy command

Projects, domains, regions, and JSON output.

HTTP command

Slugs, local hosts, socket pools, and development overrides.

Dev command

Named project tunnels, exact child commands, and access controls.

Configure Turbotunnel

Project tunnel settings in turbotunnel.json.

Configure your gateway

Saved gateway settings and deployment variables.