Skip to content
OpenChamber

Tunnels

Use openchamber tunnel to expose a running OpenChamber instance.

Quick start (Cloudflare quick mode)

  1. Start OpenChamber:
Terminal window
openchamber
  1. Start a tunnel:
Terminal window
openchamber tunnel start --provider cloudflare --mode quick
  1. Check status:
Terminal window
openchamber tunnel status

By default, OpenChamber prints a QR code in interactive TTY sessions. Use --qr to force QR output, or --no-qr to disable it.

Managed modes

Managed remote

Use a token + hostname managed by Cloudflare:

Terminal window
openchamber tunnel start --provider cloudflare --mode managed-remote --token-file ~/.secrets/cf-token --hostname app.example.com

Managed local

Use a local cloudflared config:

Terminal window
openchamber tunnel start --provider cloudflare --mode managed-local --config ~/.cloudflared/config.yml

Profiles (managed-remote)

Save a reusable profile:

Terminal window
openchamber tunnel profile add --provider cloudflare --mode managed-remote --name prod-main --hostname app.example.com --token-file ~/.secrets/cf-token

Start using the saved profile:

Terminal window
openchamber tunnel start --profile prod-main

Useful commands

Terminal window
openchamber tunnel providers
openchamber tunnel ready --provider cloudflare
openchamber tunnel doctor --provider cloudflare
openchamber tunnel stop --port 3000

Behavior notes

  • one active tunnel per OpenChamber instance (port)
  • starting a new mode/provider on same instance replaces previous tunnel
  • generating a new connect link revokes previous unused one