Guides
Expiring sessions
Auto-close a session after a duration or after the first viewer leaves.
By default a session lives until you stop it. For shares you'd rather not leave open, Porthole can close itself automatically.
After a duration
porthole host --expire 30mThe session shuts down after the given duration whether or not anyone is
connected. Durations accept Go-style units — 90s, 30m, 2h.
After the first viewer leaves
porthole host --onceThe session closes as soon as the first viewer disconnects — ideal for a one-time "look at this and we're done" share.
--expire and --once can be combined: whichever condition is met first ends
the session.
Ending it yourself
You're always in control regardless of these flags — exit your shell (exit or
Ctrl-D) or press Ctrl-C, and the session tears down immediately.