Skip to content

Session Management

How to create, list, attach, detach, and stop terminal sessions.

Create a session

relay bash                    # interactive shell
relay htop                    # run a specific command
relay --detach bash           # create without attaching (print URL)

Click the + button on the home page. Choose a shell or enter a custom command.

List sessions

relay list

The home page (/) shows all active sessions with their status and last activity.

Attach to a session

relay attach <session-id>

Press Ctrl+] to detach without killing the session.

Click any session in the list to open it in the terminal view.

Stop a session

relay stop <session-id>

Open the session info panel and tap Stop.

Warning

Stopping a session kills the underlying process. This is not reversible.

Multiple viewers

Multiple clients (CLI and browser) can connect to the same session simultaneously. Everyone sees the same output in real-time, and any connected client can type.