Skip to content

About

Claude Code VPS setup: one command turns a blank Ubuntu server into a remote Claude Code workstation with KDE Plasma over RDP, hardened SSH, Docker, tmux and synced dotfiles.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Claude Code VPS logo

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 publish at home, claude-vps sync or 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 bash

Then 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 update

Keep 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 minutes

What 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.

About

Claude Code VPS setup: one command turns a blank Ubuntu server into a remote Claude Code workstation with KDE Plasma over RDP, hardened SSH, Docker, tmux and synced dotfiles.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages