A Claude Code workstation OS for your VPS. One command turns a blank Ubuntu server into a monochrome KDE Plasma desktop you reach over RDP, with claudegrid to run several Claude Code agents side by side.
claudegrid running four Claude Code agents side by side, each on its own task.
HaltOS in 30 seconds
From the first boot line to four Claude Code agents working side by side.
What's inside
Everything HaltOS changes, listed the way your server would list it.
$ systemctl list-units 'haltos-*' claude-code-vps
Unit
Active
Description
haltos-identity
active
os-release, lsb_release and the About page say HaltOS 1.2 (SIGKILL). The ID stays ubuntu, so apt and PPAs keep working.
haltos-desktop
active
Monochrome Plasma colour scheme, JetBrains Mono everywhere, a translucent floating top bar and flat titlebars.
haltos-widgets
active
A Kvantum theme with outline buttons, quiet inputs, rounded menus, tabs and thin scrollbars that hide themselves.
haltos-gtk
active
GTK and libadwaita apps pick up the same palette, with white as the primary colour.
haltos-terminal
active
A Konsole profile, a two-line prompt with the git branch and exit code, and fastfetch with the HALTOS banner.
haltos-boot
active
A splash screen with a scrolling boot log, an SDDM login card and a Plymouth splash.
haltos-motd
active
An SSH banner with uptime, load, memory, disk and pending updates, without Ubuntu's ads.
claudegrid
active
Opens a grid of Claude Code agents in one window, with a prompt, model and git worktree per pane. See claudegrid.
haltos-editor
active
The latest VS Code from Microsoft's apt repository, so apt upgrade keeps it current.
claude-code-vps
active
Plasma over RDP, key-only SSH, ufw, Docker, Claude Code and claudegrid. Its own project, and it runs fine without HaltOS.
10 units listed.
Every surface, one palette
From the boot splash to a GNOME calculator, nothing keeps its stock colours.
The desktop right after the first RDP login.Qt and KDE apps: outline buttons, white when pressed or checked.fastfetch reports HaltOS 1.2 (SIGKILL) on top of Ubuntu.The Plasma splash, with a boot log while your session starts.The SDDM login card, for machines that boot to a display manager.libadwaita apps such as GNOME Calculator follow along.
What the command does
Run it as root on a fresh Ubuntu 25.04 or newer server. Options after bash -s -- go to claude-code-vps, for example --user dev --yes.
Checks for Plasma 6
Before installing anything. On Ubuntu 24.04, which ships Plasma 5, it stops and says why.
Sets up the workstation
claude-code-vps adds your sudo user, key-only SSH, ufw, Plasma over RDP on port 53389, Docker and Claude Code.
Gives the system its name
HaltOS identity files, login banner, Kvantum, the SDDM and Plymouth themes, and defaults for new users.
Dresses your desktop
Your user gets the theme right away. The panel and wallpaper finish on your first RDP login.
# update both layers later
sudo claude-vps update && sudo haltos update
# put Ubuntu back the way it was
haltos undo-user && sudo haltos undo-system
Why the name
HALTOS(7)HaltOS ManualHALTOS(7)
NAME
haltos - an operating system named after the command that stops one
DESCRIPTION
halt is the oldest way to stop a Unix machine. HaltOS takes the word and turns it around: a desktop that lives on a server that never sleeps, so Claude Code keeps working while you are away. Its wallpaper says it plainly: shutdown -h never.
Take the i out of Halit, the name of the person who made it, and you get halt.
CODENAME
SIGKILL, the one signal a process cannot catch or ignore. The first release is the one that ends the half-measures.
No. It is a layer on top of Ubuntu. Packages and updates still come from Ubuntu, and /etc/os-release keeps ID=ubuntu so apt, PPAs and vendor install scripts keep working. HaltOS changes how the system looks and introduces itself.
Which Ubuntu releases does it support?
Ubuntu 25.04 or newer, because HaltOS needs KDE Plasma 6. Ubuntu 24.04 ships Plasma 5, and the installer stops before changing anything there.
Do I need claude-code-vps?
The one-command install includes it. claude-code-vps sets up the server and keeps your config in sync from a git repository, HaltOS owns the look. claude-code-vps also works on its own, and HaltOS keeps its theme files out of your synced dotfiles.
Will a claude-vps sync undo the theme?
No. HaltOS lists the files it owns in claude-vps's local-only list, so a sync leaves them alone and a publish never pushes them into your public dotfiles.
How do I remove it?
haltos undo-user restores the KDE config saved before the first install. sudo haltos undo-system restores Ubuntu's identity files, login banner and defaults.