Share a local service

A Quick Share gives a service on your computer, such as a dev server on localhost:3000, a public HTTPS address like https://quiet-river-lamp-orbit.trycloudflare.com. Anyone with the link can open it until you stop sharing. It needs no Cloudflare account, no domain, no port forwarding and no configuration.

Use it to show work in progress to a colleague or client, open your site on a phone, or point a webhook at your laptop for a few minutes. Use something else when the address has to stay the same or stay up: a share on your own domain keeps its name, a route runs for as long as you like, and a Snapshot stays online when your computer is off. See choose how to share for all of them side by side.

Share in the appCopy Anchor Link

Each share's card has:

• the address, with the copy button and Open in browser,
• Show QR code, to open it on a phone,
• request and error counts, Stops in … when it has a time limit, and the connector's Log,
• Pause (when Inspect requests is on, the default), which keeps the address but shows visitors a paused page until you Resume,
• Publish a Snapshot, which turns the shared site into a static copy that stays online,
• Stop Sharing.

Quitting Teitunnel stops every Quick Share, and Cloudflare forgets the address. Sharing again gives a new one.

From the terminalCopy Anchor Link

teitunnel share 3000                  # a random trycloudflare.com URL
teitunnel share 3000 --for 30m        # stops by itself after 30 minutes
teitunnel share ./dist                # a folder of files, no server needed
teitunnel share 3000 --json           # {"url": …, "hostname": …} for scripts

$ teitunnel share 3000 --here
https://quiet-river-lamp-orbit.trycloudflare.com

█▀▀▀▀▀█ ▄▀▄ ▀▄█ █▀▀▀▀▀█
…
http://localhost:3000 is public at https://quiet-river-lamp-orbit.trycloudflare.com for anyone with the link. Press Ctrl-C to stop.

Where the share runs depends on whether the app is open:

• The app is running: the command hands the share to the app (the app may ask you to allow it the first time) and returns. The share keeps running in the app: It runs in the Teitunnel app: stop it there or with teitunnel shares --stop <url>.
• The app isn't running, or you pass --here: the share runs in the terminal until you press Ctrl-C or its --for time is up.

share needs no Cloudflare account, only cloudflared (the app's copy, or one on your system). Every option is in Sharing and the command reference.

On your own domainCopy Anchor Link

With a Cloudflare account connected (see your first route), the Address menu next to the service also offers your domains. Choose On yourhost.com, type a Subdomain such as demo (Teitunnel suggests names from the project), and Share. You get https://demo.yourhost.com, the same address every time you share under that name.

It's a temporary route on this computer's tunnel, planned and applied like any other change, and removed with its DNS record when you stop it, when its time is up, or when you quit Teitunnel (if Teitunnel crashes, it's removed the next time it starts). It never takes over a hostname that has a DNS record Teitunnel didn't create. While it runs, it shows in Routes with a Temporary badge.

teitunnel share 3000 --on demo.yourhost.com
teitunnel share 3000 --on demo.yourhost.com --allow ana@yourhost.com   # behind a login

A share on your domain always runs in the terminal that started it, until Ctrl-C.

LimitsCopy Anchor Link

Anyone who has the link can open the service while it's shared. To limit who, share on your domain with a login, or put a password page or a secret link in front of it from the shield on the share's card (protect a Quick Share).

If it doesn't workCopy Anchor Link

• "Cloudflare didn't provide a URL in time. Check your internet connection and try again." Quick Tunnels are sometimes busy. Try again, or share on your own domain.
• The page says "Blocked request" or "Invalid Host header". Vite, webpack, Angular, Django and Rails refuse hostnames they don't know. Teitunnel sends dev servers their own address by default; if yours still refuses, see share a dev server.
• 502 Bad Gateway, or nothing loads. Check the service answers at http://localhost:<port> on your own machine, and that the port is right. See troubleshooting.
• "This Quick Share hit its limit of 200 requests at once. Share on your own domain for more." Quick Tunnels have that cap; a share on your domain doesn't.

NextCopy Anchor Link