Porthole
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 30m

The 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 --once

The 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.

On this page