share

mdocker share exposes a running project through a Cloudflare quick tunnel (trycloudflare.com). Only start needs cloudflared; stop and ls work without it. See Sharing a Public Demo Link.

share <project> / share start

Start a public tunnel for a registered hostname (default: the first). Idempotent — a live tunnel just re-prints its URL.

mdocker share start

mdocker share <name>                # shortcut for share start
mdocker share start <name> [<host>]

The origin is auto-probed: the Traefik IP on :443 first (OrbStack — host :443 is not forwarded), falling back to 127.0.0.1:443 (Docker Desktop).

share stop

Kill tunnel(s). Idempotent (SIGTERM → grace → SIGKILL; removes state + log).

mdocker share stop

mdocker share stop <name> [<host> | --all]

share ls / share status

List live tunnels, pruning dead entries.

mdocker share ls

mdocker share ls
mdocker share ls <name> --json

Process model

Each tunnel is a nohup cloudflared daemon with a state JSON and log at ~/.config/multi-docker/state/tunnels/<project>__<host>.{json,log} — ephemeral runtime artefacts, not registry.json. ls self-heals stale entries.

Coupling

mdocker down <name> and mdocker rm <name> stop that project’s tunnels automatically. edge restart and a project restart do not.

Limits

URL changes on every start; no password protection; apps with absolute URLs (Shopware assets) may still point at the local domain; tunnels don’t survive a reboot; the app and standalone CLI have separate tunnel worlds (different MD_CONFIG_DIR).

Related

• Sharing a Public Demo Link