Claude Code, always on
tmux sessions that survive a dropped SSH, with your settings, hooks and status line already in place.
One command installs Claude Code, a full KDE Plasma desktop over RDP, hardened SSH and the exact config I use every day. Change your setup at home, and the server follows.
curl -fsSL https://raw.githubusercontent.com/halitsever/claude-code-vps/main/install.sh | sudo bashapt upgrade, core tools, swap and unattended security updates.
A sudo user with your SSH keys copied over.
Key-only login, no root passwords. Written so it wins over cloud-init.
ufw with only SSH and RDP open.
KDE Plasma with the X11 session. No login screen on a headless box.
xrdp on port 53389, starting Plasma, without the colord prompts.
Docker, GitHub CLI and Chrome.
Claude Code native install, plus your ntfy topic.
Your KDE layout, Claude settings, hooks and tmux config.
tmux sessions that survive a dropped SSH, with your settings, hooks and status line already in place.
Panels, shortcuts, tiling and Konsole profiles, captured at home and replayed on the server.
Key-only SSH, no root password login, ufw, unattended upgrades.
A Notification hook sends Claude's questions to ntfy.sh. Walk away.
Docker, GitHub CLI, Node, ripgrep, build tools and Chrome.
Every step checks what is there first. Run it again any time, or just --only what you need.
The repo is the source of truth. Publish from your machine, the server pulls on a timer.
claude-vps publishCaptures KDE and Claude config, scrubs home paths, commits and pushes.
git pushPlain files in dotfiles/home. Easy to diff, easy to review.
claude-vps syncPulls and applies, backing up what it replaces. Or autosync every 30 minutes.
Yes. Claude Code is a terminal app, so any Linux server works. You log in once through a link you open on your own device, and it keeps running inside tmux after you disconnect.
2 vCPU and 4 GB RAM is enough for the terminal. With the KDE Plasma desktop, 4 vCPU and 8 GB RAM feels like a real workstation.
Ubuntu 24.04 LTS and newer, including 26.04 LTS. amd64 gets everything, arm64 works without Chrome.
You need a plan that includes Claude Code (Pro or Max) or an Anthropic API key. claude-vps itself is free and MIT licensed.
xrdp encrypts the session and runs on a non-default port, but you can also keep it closed with --rdp-private and reach it through an SSH tunnel.
Yes. Fork the repo, run claude-vps capture on your machine and point the installer at your fork. The server then follows every change you publish.
Hetzner, DigitalOcean, a spare box at home: anything on Ubuntu 24.04 or newer.
curl -fsSL https://raw.githubusercontent.com/halitsever/claude-code-vps/main/install.sh | sudo bash