Session Management

Termote uses tmux windows for persistent sessions that survive disconnects.

Default Session

Fresh installs start with a single Shell session. Create additional sessions as needed for different workflows (e.g., Claude Code, Copilot, builds).

Managing Sessions

Desktop

Switch: Click session in left sidebar
Edit: Double-click session name, or hover and click pencil icon
Remove: Hover and click X icon (requires 2+ sessions)
Add: Click ”+ Add session” at bottom

Mobile

Switch: Swipe right to open sidebar, tap session
Edit: Swipe left on session, tap Edit
Remove: Swipe left on session, tap Remove
Add: Tap ”+ Add session” in sidebar

Session Features

Feature	Description
Custom icons	Choose emoji icon for each session
Rename	Change session name anytime
Auto-sync	Sessions sync across browsers every 5s
Persistence	Sessions backed by tmux windows

tmux Commands

# List windows (sessions)
tmux list-windows

# Create new window
tmux new-window -n myproject

# Switch to window
tmux select-window -t 0

# Kill window
tmux kill-window -t 0

API Endpoints

Sessions are managed via tmux-api:

Endpoint	Method	Description
`/api/tmux/windows`	GET	List all sessions
`/api/tmux/new?name=X`	POST	Create session
`/api/tmux/select/{id}`	POST	Switch session
`/api/tmux/rename/{id}?name=X`	POST	Rename session
`/api/tmux/kill/{id}`	POST/DELETE	Remove session

Troubleshooting

Session not persisting

Check tmux is running: tmux list-windows
Verify ttyd uses -A flag (attach-or-create)
Check container logs: docker logs termote or podman logs termote

WebSocket errors

Check container logs: docker logs termote or podman logs termote
Verify ttyd is running on port 7681
Check API health: curl http://localhost:7680/api/tmux/health