Corterm

Remote Terminals, Everywhere.

简体中文

Corterm is a self-hosted remote terminal platform. Install a lightweight Worker on any machine, deploy the Gateway, and access your terminals from any browser or mobile device -- your shell keeps running even after you close the tab.

Architecture

Browser  ──►  Gateway  ──►  Worker
 (UI)          (Auth,         (PTY,
                Routing,       Shell
                Sessions)      Execution)

• Gateway -- Central server handling authentication, session routing, and real-time communication.
• Worker -- Lightweight agent that runs on your machines, manages PTY sessions, and streams I/O back to the Gateway.
• Console -- Browser-based terminal UI served by the Gateway. Also available as native iOS and Android apps.

Features

• Browser-Native Terminal -- Full xterm.js terminal with WebGL rendering. Works on desktop, tablet, and mobile.
• Session Persistence -- Detach and reattach at any time. Your shell keeps running. Previous output is replayed on reattach.
• Multi-Worker -- Connect and manage any number of remote machines from a single Gateway.
• Mobile Access -- Native iOS and Android apps with custom terminal keyboard, haptic feedback, and responsive layout.
• Multiple Auth Methods -- Password, phone SMS, GitHub OAuth, Google OAuth, and Apple Sign-In.
• Worker Management -- Monitor worker status, trigger remote upgrades, and run diagnostics (corterm doctor).
• Admin Dashboard -- User management, invitations, role-based access, and audit logging.
• Self-Hosted & Docker Ready -- One command to deploy. No cloud dependency. Your data stays on your infrastructure.

Quick Start

1. Deploy the Gateway

docker run -p 5045:5045 ghcr.io/monster-echo/corterm-gateway:latest

2. Install the Worker

Linux / macOS:

curl -fsSL https://corterm.rwecho.top/install.sh | sh

Windows (PowerShell):

powershell -Command "irm https://corterm.rwecho.top/install.ps1 | iex"

3. Open Your Browser

Navigate to http://localhost:5045, log in, and start a terminal session.

Platform Support

Worker: Linux (amd64 / arm64) · macOS (Apple Silicon) · Windows x64 · Docker

Client: Any modern browser · iOS · Android

Mobile App Download

Tech Stack

.NET 10 (Gateway / Worker) · React 19 + xterm.js (Console) · .NET MAUI + Ionic (Mobile) · SignalR + MessagePack

Roadmap

• File Transfer -- Upload and download files directly through the terminal session
• Port Forwarding -- Tunnel local ports to remote machines via the Gateway
• Structured Output -- Render common command outputs (top, ps, docker ps) as interactive cards instead of raw text
• Multi-tab Terminal -- Open multiple sessions in a single browser tab
• Command Snippets -- Save and reuse frequently used commands across sessions

License

MIT