← Back to list
01Issue
FeatureShippedSwamp ClubPublic
AssigneesNone
Relationships
↔ sibling #4556#4515 Docs: swamp dashboard --port, --trusted-hosts and its new lifetime (swamp-club#4513, #4509)
Opened by stack72 · 11/8/2026· Shipped 11/10/2026
swamp-club#4513 and swamp-club#4509 change swamp dashboard. The manual page content/manual/reference/swamp-serve/dashboard.md, section "swamp dashboard", needs updating once it ships.
What changed
- The usage line gains two flags:
swamp dashboard [--repo-dir <dir>] [--no-browser] [--port <port>] [--trusted-hosts <hosts>]. --port <port>: the dashboard listens on 127.0.0.1 on that port instead of any free port, so a reverse proxy has a fixed upstream. A port in use is an error naming it.--trusted-hosts <hosts>: comma-separated host names or host:port, the same shape asswamp serve --trusted-hosts. Requests whose Host is one of them are served instead of answered with 421; the page token is still required on every request. It is for a reverse proxy on the same machine (tailscale serve, caddy) that forwards the browser's Host. nginx sends its upstream address by default and needs only--port. The startup output adds a "Through your proxy, open:" link for each name, which assumes the proxy serves HTTPS; through a plain-http proxy the token crosses the network unencrypted.- The line "The server listens only on 127.0.0.1." stays true: there is no option to bind another address.
- Lifetime:
swamp dashboardnow keeps running when the terminal or session that started it closes (it ignores SIGHUP), and no longer stops itself ten minutes after the last tab closes. Ctrl-C or SIGTERM stops it. It can be backgrounded with a plain&, nosetsidornohupneeded.
Suggested additions
- The two flags in the usage block and option list.
- A short example behind a proxy:
swamp dashboard --no-browser --port 8765 --trusted-hosts my-machine.tailnet-name.ts.netwithtailscale serve --bg 8765. - A sentence on how to stop a backgrounded dashboard (Ctrl-C in its terminal, or SIGTERM).
- The example output and the sentence before it (around "terminal keeps the page running until Ctrl-C" and the sample line "This terminal keeps the page running. Press Ctrl-C to stop it.") are now stale for
swamp dashboard: its last line reads "Press Ctrl-C to stop it. Closing this terminal leaves it running." With--trusted-hosts, a "Through your proxy (it must serve HTTPS), open:" heading and one URL per name print just before it.
02Bog Flow
Shipped
Click a lifecycle step above to view its details.
03Sludge Pulse
Sign in to post a ripple.