Guides
Password-protected sessions
Require a password before anyone can join your session.
A session link is a capability — anyone who has it can connect. When a link might be seen by people you don't want in, gate the session with a password.
porthole host --password "correct horse"When a viewer opens the link, the browser prompts for the password before the connection is established. The wrong password never reaches your terminal.
Keeping the password out of shell history
Pass it through the environment instead of the command line:
PORTHOLE_PASSWORD="correct horse" porthole hostA flag always wins over the environment variable, which always wins over the
default. So --password on the command line overrides PORTHOLE_PASSWORD.
Combine with read-only
Password and read-only stack — a gated, view-only session:
porthole host --password "correct horse" --readonly