clutchcall commands into
a realistic scenario.
Recipe 1 — Ship a public demo URL with a stable subdomain
Take a local web app fromlocalhost:3000 to a shareable HTTPS URL. With a
reserved subdomain, the URL survives restarts and Wi-Fi changes.
1
Sign in once
2
Reserve your subdomain
3
Expose the app
acme.clutchcall.dev back over those streams to localhost:3000.4
Run named tunnels for extra services
5
Verify it from anywhere
A stranger on the internet loads
https://acme.clutchcall.dev. WebSocket
upgrade, SSE, and large uploads all pass through. If your laptop hops from
Wi-Fi to cellular, QUIC migration keeps the URL live without a reconnect.The URL is reachable from every region. When traffic lands on a far PoP, the
edge mesh routes it to the PoP that your box is connected to.
Recipe 2 — A private cross-NAT database link
Reach a Postgres instance on a home server from your laptop on a different network. There are no inbound ports. The edge never carries your bytes.1
Configure a STUN reflector on both boxes
ip:port) so the
two can punch toward each other.2
Share the database from the home server
pglink is a shared pair-id. Both peers agree on it out of band. The CLI
binds a local UDP port and gathers candidates with STUN. It publishes its
candidates to the rendezvous, then waits for the peer.3
Connect from the laptop
4
Use the link
psql connection becomes its own QUIC stream over the direct link.
The pair-id gates the tunnel end to end. The edge only saw the candidate
exchange. It never saw query bytes.Why no inbound port is ever opened
Why no inbound port is ever opened
Both peers are QUIC clients that dial outward. The peer that dials is the
client. The home server never accepts an unsolicited inbound connection. Thus
there is no firewall hole to punch and no static public IP to maintain.
Recipe 3 — Remote desktop over the raw-QUIC relay
Control a headless box from a laptop with QuickDesk. Its transport rides the same tunnel relay. Both legs are QUIC. End-to-end encryption is QuickDesk’s own.1
Point both clients at the relay
In QuickDesk’s network settings, set the relay endpoint:This replaces QuickDesk’s own rendezvous/relay with the ClutchCall tunnel
relay (ALPN
clutchcall-engine).2
The controlled box registers
On start, the controlled box dials the relay. It registers its device id
as a slug with
"proto":"quick". It then pre-opens and parks bidi work
streams. This is exactly the parked-stream pool that the HTTP/TCP tunnels
use.3
The controller dials by slug
The controller enters the box’s device id. The relay looks up the slug and
pops a parked stream. It writes an
open metadata frame. It then splices
the controller’s QUIC stream to the box’s parked stream.4
Session runs end to end encrypted
QuickDesk’s signed key exchange and message framing ride unchanged on top
of the QUIC byte pipe. The relay is untrusted. QUIC TLS only secures
the hop to the PoP. Confidentiality and peer auth stay in QuickDesk’s own
crypto.
QuickDesk speaks the tunnel wire protocol directly. This path needs no extra
CLI. The HTTP/TCP/P2P tunnels and the QuickDesk session all share one
transport, one slug namespace, and one parked-stream model. See the
QuickDesk docs for clients and self-hosting.
Recipe 4 — Self-hosted control plane + edge
Run the whole stack against your own infrastructure for a zero-trust ingress to internal services.1
Point the CLI at your control plane
2
Expose an internal admin panel
3
Gate access at the edge
Front the public URL with your SSO/OIDC at the edge. Then only
authenticated users reach the internal service. This is the zero-trust
ingress pattern. The box-side agent stays a pure byte pipe. Policy lives at
the PoP.
Related
- Tunnel overview — wire model & architecture
- SDK & CLI — full command surface
- Cookbook — short task snippets

