Skip to content

docs: document warden share and the Cloudflare Tunnel provider - #53

Open
lbajsarowicz wants to merge 1 commit into
wardenenv:mainfrom
lbajsarowicz:feature/cloudflare-tunnel-docs
Open

docs: document warden share and the Cloudflare Tunnel provider#53
lbajsarowicz wants to merge 1 commit into
wardenenv:mainfrom
lbajsarowicz:feature/cloudflare-tunnel-docs

Conversation

@lbajsarowicz

@lbajsarowicz lbajsarowicz commented Mar 22, 2026

Copy link
Copy Markdown
Contributor

Documents the warden share command introduced in wardenenv/warden#923, which exposes a local Warden project to the public internet through a share provider, with Cloudflare Tunnel as the first provider.

New page configuration/share.md: what the command is for, how traffic flows (provider edge, share agent on the warden network, Traefik, the project's Nginx or Varnish), the two configuration scopes (per-developer WARDEN_SHARE_PROVIDER in ~/.warden/.env, per-project TRAEFIK_PUBLIC_DOMAIN in .env or .env.local), the Cloudflare Tunnel setup including the DNS record the user has to create, how the ingress configuration is regenerated, troubleshooting, and a short note for contributors on adding another provider.

Also: services.md lists the share agent as an optional global service, index.md gains one feature bullet, and environments/customizing.md gets a section on .env.local overrides, which the CLI supports since wardenenv/warden#942 but the docs did not mention.

Replaces the earlier revision of this branch that documented warden cf. Should be merged together with wardenenv/warden#923.

@ilnytskyi

Copy link
Copy Markdown

great idea.

For even more simplicity quick tunnels can be supported too https://developers.cloudflare.com/cloudflare-one/networks/connectors/cloudflare-tunnel/do-more-with-tunnels/trycloudflare/

They don't require account or domain name, yet they generate random domain, and have other limits but they quick.

@lbajsarowicz

lbajsarowicz commented Mar 23, 2026

Copy link
Copy Markdown
Contributor Author

Great idea! I wasn't aware of it.

Added in the 2nd phase: wardenenv/warden#924

@lbajsarowicz
lbajsarowicz force-pushed the feature/cloudflare-tunnel-docs branch from 74180b5 to 59a66ca Compare September 7, 2026 21:26
@lbajsarowicz lbajsarowicz changed the title docs: add Cloudflare Tunnel documentation docs: document warden share and the Cloudflare Tunnel provider Sep 7, 2026
Add configuration/share.md covering the share command, the traffic path
through Traefik, per-developer and per-project configuration, Cloudflare
Tunnel setup including the DNS record, configuration regeneration and
troubleshooting. List the share agent under global services, add a
feature bullet, and document .env.local overrides in customizing.md.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants