Run Claude Code on a VPS. One command turns a blank Ubuntu server into a remote Claude Code workstation:
KDE Plasma over RDP, hardened SSH, tmux, Docker, Chrome and your own KDE + Claude config.
Documentation · VPS guide · Español · Deutsch · Français · Português · Italiano · Русский · 简体中文 · 日本語 · 한국어 · Türkçe
- One command setup - base packages, sudo user, key-only SSH, ufw, KDE Plasma, xrdp, Docker, gh, Chrome, Claude Code and claudegrid
- Step-by-step VPS guide - every step by hand, if you would rather not run a script
- Config sync -
claude-vps publishat home,claude-vps syncor autosync on the server - Phone notifications - a Notification hook that pushes "Claude is waiting" to ntfy.sh
- HaltOS - an optional monochrome, terminal-style desktop on top of this setup, installed together with claude-code-vps in one command
On a fresh Ubuntu 24.04+ server, as root:
curl -fsSL https://raw.githubusercontent.com/halitsever/claude-code-vps/main/install.sh | sudo bashThen SSH in as the new user, run tmux and claude, or connect to the desktop with any RDP client on port 53389.
When a new version is released, update each server with:
sudo claude-vps updateKeep the server in sync with your own machine:
claude-vps publish # on your machine: capture KDE + Claude config, commit, push
claude-vps sync # on the server: pull and apply
claude-vps autosync on # or let the server pull every 30 minutesWhat gets captured is listed in dotfiles/manifest.txt. Credentials are never part of it.
Found a bug or have an idea? Open an issue.
Read the contributing guide before sending a pull request.
Not affiliated with Anthropic.
Released under the MIT License.