Skip to content

A blank server in. Your Claude workstation out.

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 bash
Ubuntu 26.04✦KDE Plasma 6✦xrdp✦tmux✦Claude Code✦Docker✦GitHub CLI✦Chrome✦ntfy.sh✦ufw✦systemd timers✦VitePress✦Ubuntu 26.04✦KDE Plasma 6✦xrdp✦tmux✦Claude Code✦Docker✦GitHub CLI✦Chrome✦ntfy.sh✦ufw✦systemd timers✦VitePress✦
1command
9setup steps
~10minutes
11languages
Under the hood

Nine steps. All readable bash.

01/09
==> base
✓ base system ready
Read every step in detail →
  1. 01

    base

    apt upgrade, core tools, swap and unattended security updates.

  2. 02

    user

    A sudo user with your SSH keys copied over.

  3. 03

    ssh

    Key-only login, no root passwords. Written so it wins over cloud-init.

  4. 04

    firewall

    ufw with only SSH and RDP open.

  5. 05

    desktop

    KDE Plasma with the X11 session. No login screen on a headless box.

  6. 06

    rdp

    xrdp on port 53389, starting Plasma, without the colord prompts.

  7. 07

    apps

    Docker, GitHub CLI and Chrome.

  8. 08

    claude

    Claude Code native install, plus your ntfy topic.

  9. 09

    dotfiles

    Your KDE layout, Claude settings, hooks and tmux config.

What you get

Everything a long-running agent needs.

claude

Claude Code, always on

tmux sessions that survive a dropped SSH, with your settings, hooks and status line already in place.

plasma

Your KDE, not a default one

Panels, shortcuts, tiling and Konsole profiles, captured at home and replayed on the server.

security

Locked down

Key-only SSH, no root password login, ufw, unattended upgrades.

ntfy

Pings your phone

A Notification hook sends Claude's questions to ntfy.sh. Walk away.

tools

Dev stack

Docker, GitHub CLI, Node, ripgrep, build tools and Chrome.

idempotent

Re-runnable

Every step checks what is there first. Run it again any time, or just --only what you need.

Stay in sync

Tweak at home. It shows up on the server.

The repo is the source of truth. Publish from your machine, the server pulls on a timer.

01

Your machine

claude-vps publish

Captures KDE and Claude config, scrubs home paths, commits and pushes.

02

GitHub

git push

Plain files in dotfiles/home. Easy to diff, easy to review.

03

Server

claude-vps sync

Pulls and applies, backing up what it replaces. Or autosync every 30 minutes.

FAQ

Questions people ask

Can Claude Code run on a VPS?

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.

What size server do I need for Claude Code?

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.

Which Ubuntu versions does claude-vps support?

Ubuntu 24.04 LTS and newer, including 26.04 LTS. amd64 gets everything, arm64 works without Chrome.

Do I need a Claude subscription?

You need a plan that includes Claude Code (Pro or Max) or an Anthropic API key. claude-vps itself is free and MIT licensed.

Is it safe to expose RDP?

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.

Can I use my own KDE and Claude settings?

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.

Your next server is ten minutes away.

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

MIT licensed. Not affiliated with Anthropic.