Cloud Overview

kexsh cloud lets you access your local terminal sessions from any device through a web browser. Your terminals run on your machine — the cloud provides a secure bridge.

How it works

Your machine                    kexsh cloud                    Browser
┌──────────┐    WebSocket     ┌──────────┐     HTTPS      ┌──────────┐
│ kexsh CLI │ ──────────────→ │ Relay    │ ←──────────── │ Web UI   │
│ + server  │ ←────────────── │ Server   │ ──────────→   │          │
└──────────┘   bidirectional  └──────────┘  bidirectional └──────────┘

1. The kexsh server runs locally and manages your terminal processes
2. When you sync a terminal, the CLI opens a WebSocket to the cloud relay
3. Terminal I/O is forwarded in real-time over the encrypted connection
4. You (or your other devices) connect through the web dashboard

Key principles

• Opt-in per terminal — only terminals you explicitly sync are accessible remotely
• Local-first — kexsh works fully offline; cloud features are optional
• End-to-end encrypted — all traffic uses TLS (WSS + HTTPS)
• No data storage — the relay forwards I/O in real-time, nothing is persisted on the server

Getting started with cloud

1. Register your device — kexsh login
2. Sync a terminal — kexsh terminal sync <id>
3. Open the dashboard — manage from the web