# Termix — Web-Based Server Management with SSH Terminal & Tunneling

> A self-hosted server management platform providing a web-based SSH terminal, secure tunneling, and file editing capabilities in a lightweight Docker container.

## Install

Save as a script file and run:

# Termix — Web-Based Server Management with SSH Terminal & Tunneling

## Quick Use
```bash
docker run -d --name termix 
  -p 3000:3000 
  -v termix-data:/data 
  ghcr.io/termix-ssh/termix:latest
# Open http://localhost:3000
```

## Introduction
Termix is a self-hosted, web-based server management platform that provides SSH terminal access, secure tunneling, and file editing from your browser. It replaces the need for desktop SSH clients and offers a centralized dashboard to manage multiple servers with team access controls.

## What Termix Does
- Provides a full SSH terminal in the browser with xterm.js for responsive, low-latency sessions
- Manages multiple server connections from a single dashboard with saved credentials
- Enables secure TCP tunneling to access remote services behind firewalls
- Includes a built-in file manager and code editor for remote file operations
- Supports multi-user access with role-based permissions for team environments

## Architecture Overview
Termix is built with TypeScript using a Node.js backend that proxies SSH connections through WebSockets to the browser. The frontend renders terminal sessions via xterm.js. Server credentials and configuration are stored in a local SQLite database. SSH tunneling is implemented natively, forwarding TCP ports through encrypted channels. The entire application runs in a single Docker container.

## Self-Hosting & Configuration
- Deploy with a single Docker command; only port 3000 is required
- Mount a persistent volume at `/data` to preserve server configurations and user accounts
- Set `TERMIX_SECRET` environment variable for session encryption
- Configure HTTPS by placing your TLS certificates or using a reverse proxy like Caddy or Nginx
- Add servers via the web UI with hostname, port, username, and key-based or password authentication

## Key Features
- Zero-install browser access to SSH terminals from any device
- Built-in SSH key management with generation and import support
- File manager with drag-and-drop upload and inline text editor
- Session recording and playback for audit compliance
- Lightweight single-container deployment under 100 MB

## Comparison with Similar Tools
- **Guacamole** — Supports RDP/VNC/SSH but requires complex multi-container setup; Termix is SSH-focused and simpler
- **Teleport** — Enterprise access platform with steep learning curve; Termix is lightweight and quick to deploy
- **WebSSH2** — Basic web SSH client; Termix adds file management, tunneling, and multi-user support
- **Shell In A Box** — Legacy project no longer maintained; Termix offers a modern UI and active development
- **MobaXterm** — Desktop-only application; Termix provides browser-based access from anywhere

## FAQ
**Q: Does Termix store SSH passwords in plaintext?**
A: No. Credentials are encrypted at rest using the `TERMIX_SECRET` key. SSH key-based authentication is recommended for production use.

**Q: Can I use Termix behind a corporate proxy?**
A: Yes. Termix works behind reverse proxies with WebSocket support. Configure your proxy to forward upgrade headers for the `/ws` path.

**Q: Is there an API for automation?**
A: Termix provides a REST API for server management operations including creating connections, triggering commands, and managing users programmatically.

**Q: What browsers are supported?**
A: Any modern browser with WebSocket support works, including Chrome, Firefox, Safari, and Edge. Mobile browsers are supported with a responsive terminal layout.

## Sources
- https://github.com/Termix-SSH/Termix
- https://termix.sh

---
Source: https://tokrepo.com/en/workflows/1af56573-4080-11f1-9bc6-00163e2b0d79
Author: Script Depot