gnmyt/Nexterm: The open source server management software for SSH, VNC & RDP

[![Contributors][contributors-shield]][contributors-url] [![Forks][forks-shield]][forks-url] [![Stargazers][stars-shield]][stars-url] [![Issues][issues-shield]][issues-url] [![MIT License][license-shield]][license-url] [![Release][release-shield]][release-url]

🤔 What is Nexterm?

Nexterm is an open-source server management software that allows you to:

• Connect remotely via SSH, VNC and RDP
• Manage files through SFTP
• Deploy applications via Docker
• Manage Proxmox LXC and QEMU containers
• Secure access with two-factor authentication and OIDC SSO
• Separate users and servers into Organizations

📷 Screenshots

🚀 Install

You can install Nexterm by clicking here.

💻 Development

Prerequisites

• Node.js 18+
• Yarn
• FlatBuffers compiler (flatc)
• Docker (optional)

| Platform | Command | |----------|---------| | macOS | brew install flatbuffers | | Ubuntu / Debian | sudo apt install flatbuffers-compiler | | Windows | winget install Google.FlatBuffers |

Local Setup

Clone the repository

git clone https://github.com/gnmyt/Nexterm.git
cd Nexterm

Configure environment

Create a local environment file:

cp .env.example .env

Make sure ENCRYPTION_KEY is set in .env.

You can generate a secure key using:

| Platform | Command | |----------|---------| | macOS / Linux | openssl rand -hex 32 |

Install dependencies

yarn install
cd client && yarn install
cd ..

Generate FlatBuffers schemas

yarn schema:generate

This step is required before starting the development server.

Start development mode

yarn dev

Start an engine

The development server does not automatically start an engine. To connect to servers, an engine must be running separately:

yarn dev:engine

If using local engine registration, set LOCAL_ENGINE_TOKEN in the server environment and use the same value as REGISTRATION_TOKEN for the engine.

🔧 Configuration

Docker Images

| Image | Description | |------------------|----------------------------------------------------------| | nexterm/aio | All-In-One — server, client, and engine bundled together | | nexterm/server | Server + web client only (requires external engine) | | nexterm/engine | Engine only |

The server listens on port 6989 by default. You can modify this behavior using environment variables:

• SERVER_PORT: Server listening port (default: 6989)
• CONTROL_PLANE_PORT: TCP port for engine communication (default: 7800)
• NODE_ENV: Runtime environment (development/production)
• ENCRYPTION_KEY: Encryption key for passwords, SSH keys and passphrases. Supports Docker secrets via

• AI_SYSTEM_PROMPT: Extra instructions appended to the AI assistant's system prompt (example: Always explain destructive commands before running them.)
• LOG_LEVEL: Logging level for application and engine (system/info/verbose/debug/warn/error, default: system)
• TRUST_PROXY: Number of reverse proxies in front of Nexterm, so logs and audits show the real client IP instead of the

1. Fork the project
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request