Tutorials
Sharing a Terminal
Share a live terminal session with anyone — no accounts, no setup on their end. They get a read-only view of your terminal in real-time.
What you'll need
- A running relay-tty session
- The web server running (with
--tunnelfor remote sharing)
Step 1: Start a session
relay bash
relay server start --tunnelStep 2: Generate a share link
relay share <session-id>
# https://abc123.relaytty.com/s/eyJ...
# Read-only link (expires in 60m)The URL goes to stdout, metadata to stderr (POSIX convention). Pipe it directly:
relay share abc12345 | pbcopy # macOS- Open a session in the web UI
- Tap the settings icon, then Share
- Choose expiration time and optional password
- Copy the link or scan the QR code
- Expiration — how long the link stays active (5 min to 24 hours)
- Password toggle — optionally require a password to view
- Generate link — creates the share URL and QR code
Step 3: Send the link
Send the URL to anyone. They open it in a browser and see your terminal output in real-time. No login required.
Read-only
Share links are read-only. Viewers can see your terminal but cannot type or interact.
Options
Password protection
Add a password to the share link:
relay share <session-id> --password mysecretViewers must enter the password before seeing the terminal.
Custom TTL
Default expiration is 1 hour. Maximum is 24 hours:
relay share <session-id> --ttl 86400 # 24 hours
relay share <session-id> --ttl 300 # 5 minutesQR codes
The web UI share dialog generates a QR code automatically — useful for sharing with someone in the same room.
Next steps
- Session management — manage multiple sessions
- Security model — how share tokens work