--- description: Wrangler commands for managing Cloudflare Tunnels. title: Tunnel image: https://developers.cloudflare.com/og-docs.png --- [Skip to content](#main-content) > Documentation Index > Fetch the complete documentation index at: https://developers.cloudflare.com/workers/llms.txt > Use this file to discover all available pages before exploring further. # Tunnel Last updated Aug 24, 2026|Copy as Markdown|[View as Markdown](https://docs-durable-objects-instance-replaced-errors.previews.developers.cloudflare.com/workers/wrangler/commands/tunnel/index.md)|[Agent setup](https://docs-durable-objects-instance-replaced-errors.previews.developers.cloudflare.com/agent-setup/) Manage [Cloudflare Tunnels](https://docs-durable-objects-instance-replaced-errors.previews.developers.cloudflare.com/tunnel/) directly from Wrangler. Create, run, and manage tunnels that securely connect your local services to Cloudflare's network — no public IPs required. Note All `wrangler tunnel` commands are **experimental** and may change without notice. Wrangler manages the [cloudflared](https://docs-durable-objects-instance-replaced-errors.previews.developers.cloudflare.com/tunnel/downloads/) binary automatically. On first use, Wrangler will prompt you to download `cloudflared` to a local cache directory. You can skip this by installing `cloudflared` yourself and adding it to your `PATH`, or by setting the `CLOUDFLARED_PATH` environment variable to point to an existing binary. ### `tunnel create` Create a new remotely managed [Cloudflare Tunnel](https://docs-durable-objects-instance-replaced-errors.previews.developers.cloudflare.com/tunnel/). ```txt wrangler tunnel create ``` * `NAME` `string`required * A name for your tunnel. Must be unique within your account. Tunnels created via Wrangler are always **remotely managed** — configure them in the [Cloudflare dashboard ↗](https://dash.cloudflare.com/?to=/:account/tunnels) or via the API. After creation, use `wrangler tunnel run` with the tunnel ID to start the tunnel. ```sh npx wrangler tunnel create my-app ``` ```sh Creating tunnel "my-app" Created tunnel. ID: f70ff985-a4ef-4643-bbbc-4a0ed4fc8415 Name: my-app To run this tunnel, configure its ingress rules in the Cloudflare dashboard, then run: wrangler tunnel run f70ff985-a4ef-4643-bbbc-4a0ed4fc8415 ``` The following global flags work on every command: * `--help` `boolean` * Show help. * `--config` `string` (not supported by Pages) * Path to your [Wrangler configuration file](https://docs-durable-objects-instance-replaced-errors.previews.developers.cloudflare.com/workers/wrangler/configuration/). * `--cwd` `string` * Run as if Wrangler was started in the specified directory instead of the current working directory. --- ### `tunnel delete` Delete a Cloudflare Tunnel from your account. ```txt wrangler tunnel delete [OPTIONS] ``` * `TUNNEL` `string`required * The name or UUID of the tunnel to delete. * `--force` `boolean`optional * Skip the confirmation prompt. Caution Deleting a tunnel is permanent and cannot be undone. Any active connections through the tunnel will be terminated. ```sh npx wrangler tunnel delete f70ff985-a4ef-4643-bbbc-4a0ed4fc8415 ``` ```sh Are you sure you want to delete tunnel "f70ff985-a4ef-4643-bbbc-4a0ed4fc8415"? This action cannot be undone. (y/n) Deleting tunnel f70ff985-a4ef-4643-bbbc-4a0ed4fc8415 Tunnel deleted. ``` The following global flags work on every command: * `--help` `boolean` * Show help. * `--config` `string` (not supported by Pages) * Path to your [Wrangler configuration file](https://docs-durable-objects-instance-replaced-errors.previews.developers.cloudflare.com/workers/wrangler/configuration/). * `--cwd` `string` * Run as if Wrangler was started in the specified directory instead of the current working directory. --- ### `tunnel info` Display details about a Cloudflare Tunnel, including its ID, name, status, and creation time. ```txt wrangler tunnel info ``` * `TUNNEL` `string`required * The name or UUID of the tunnel to inspect. ```sh npx wrangler tunnel info f70ff985-a4ef-4643-bbbc-4a0ed4fc8415 ``` ```sh Getting tunnel details ID: f70ff985-a4ef-4643-bbbc-4a0ed4fc8415 Name: my-app Status: healthy Created: 2025-01-15T10:30:00Z Type: cfd_tunnel ``` The following global flags work on every command: * `--help` `boolean` * Show help. * `--config` `string` (not supported by Pages) * Path to your [Wrangler configuration file](https://docs-durable-objects-instance-replaced-errors.previews.developers.cloudflare.com/workers/wrangler/configuration/). * `--cwd` `string` * Run as if Wrangler was started in the specified directory instead of the current working directory. --- ### `tunnel list` List all Cloudflare Tunnels in your account. ```txt wrangler tunnel list ``` The output includes the tunnel ID, name, status, and creation date for each tunnel. Only non-deleted tunnels are shown. ```sh npx wrangler tunnel list ``` ```sh Listing Cloudflare Tunnels ID Name Status Created f70ff985-a4ef-4643-bbbc-4a0ed4fc8415 my-app healthy 2025-01-15T10:30:00Z 550e8400-e29b-41d4-a716-446655440000 api-tunnel inactive 2025-01-10T15:45:00Z ``` The following global flags work on every command: * `--help` `boolean` * Show help. * `--config` `string` (not supported by Pages) * Path to your [Wrangler configuration file](https://docs-durable-objects-instance-replaced-errors.previews.developers.cloudflare.com/workers/wrangler/configuration/). * `--cwd` `string` * Run as if Wrangler was started in the specified directory instead of the current working directory. --- ### `tunnel run` Run a Cloudflare Tunnel using the [cloudflared](https://docs-durable-objects-instance-replaced-errors.previews.developers.cloudflare.com/tunnel/downloads/) daemon. This starts a persistent connection between your local machine and Cloudflare's network. ```txt wrangler tunnel run [TUNNEL] [OPTIONS] ``` * `TUNNEL` `string`optional * The name or UUID of the tunnel to run. Required unless `--token` is provided. * `--token` `string`optional * A tunnel token to use directly. Skips API authentication. * `--log-level` `string`(default: info) optional * Log level for `cloudflared`. Does not affect Wrangler logs (controlled by `WRANGLER_LOG`). One of: `debug`, `info`, `warn`, `error`, `fatal`. Named tunnels are **remotely managed** — configure ingress rules (which local services to expose) in the [Cloudflare dashboard ↗](https://dash.cloudflare.com/?to=/:account/tunnels) or via the API before running the tunnel. There are two ways to run a tunnel: **By tunnel name or ID** (fetches the token via the API): ```sh npx wrangler tunnel run my-app ``` **By token** (no API authentication needed — useful for CI/CD or remote servers): ```sh npx wrangler tunnel run --token eyJhIjoiNGE2MjY... ``` Note The tunnel token is passed to `cloudflared` via the `TUNNEL_TOKEN` environment variable rather than CLI arguments, preventing it from appearing in process listings. Press `Ctrl+C` to stop the tunnel. Wrangler will send a graceful shutdown signal to `cloudflared` before exiting. The following global flags work on every command: * `--help` `boolean` * Show help. * `--config` `string` (not supported by Pages) * Path to your [Wrangler configuration file](https://docs-durable-objects-instance-replaced-errors.previews.developers.cloudflare.com/workers/wrangler/configuration/). * `--cwd` `string` * Run as if Wrangler was started in the specified directory instead of the current working directory. --- ### `tunnel quick-start` Start a free, temporary tunnel without a Cloudflare account using [Quick Tunnels](https://docs-durable-objects-instance-replaced-errors.previews.developers.cloudflare.com/tunnel/setup/#quick-tunnels-development). This is useful for quick demos, testing webhooks, or sharing local development servers. ```txt wrangler tunnel quick-start ``` * `URL` `string`required * The local URL to expose (for example, `http://localhost:8080`). The tunnel is assigned a random `*.trycloudflare.com` subdomain and lasts for the duration of the process. ```sh npx wrangler tunnel quick-start http://localhost:8080 ``` ```sh Starting quick tunnel to http://localhost:8080... Your tunnel URL: https://random-words-here.trycloudflare.com ``` Note Quick tunnels are anonymous and temporary — they do not appear in your account's tunnel list and cannot be configured. For production use, create a named tunnel with `wrangler tunnel create`. The following global flags work on every command: * `--help` `boolean` * Show help. * `--config` `string` (not supported by Pages) * Path to your [Wrangler configuration file](https://docs-durable-objects-instance-replaced-errors.previews.developers.cloudflare.com/workers/wrangler/configuration/). * `--cwd` `string` * Run as if Wrangler was started in the specified directory instead of the current working directory. Was this helpful? YesNo ## On this page [![](https://docs-durable-objects-instance-replaced-errors.previews.developers.cloudflare.com/_astro/logo.te5VL_aD.svg)Docs](https://docs-durable-objects-instance-replaced-errors.previews.developers.cloudflare.com/) ```json {"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/workers/wrangler/commands/tunnel/#page","headline":"Tunnel · Cloudflare Workers docs","description":"Wrangler commands for managing Cloudflare Tunnels.","url":"https://developers.cloudflare.com/workers/wrangler/commands/tunnel/","inLanguage":"en","image":"https://developers.cloudflare.com/og-docs.png","dateModified":"2026-08-24","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}} ```