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 --tunnel for remote sharing)

Step 1: Start a session

relay bash
relay server start --tunnel

Step 2: Generate a share link

relay share <session-id>
# https://abc123.relaytty.com/s/eyJ...
# Read-only link (expires in 60m)

relay share abc12345 | pbcopy  # macOS

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.

Options

Password protection

Add a password to the share link:

relay share <session-id> --password mysecret

Viewers 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 minutes

QR 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