TouchWorkStation/omarchy-server
DevOps & Self-hostingTurns an Omarchy Arch machine into a browser-managed home server for self-hosted apps, files, VMs and remote desktop.
What it does
Omarchy Server turns an existing Omarchy machine (Arch Linux + Hyprland) into a home server controlled entirely from a browser. It bundles a self-hosted app catalog of roughly 580 services, file browsing over the real home directory, libvirt virtual machines, a web terminal, storage pools (Btrfs and optionally ZFS) and remote access to the actual Omarchy desktop. The interface adapts to phones, tablets and desktops, and desktop layout settings such as themes, wallpaper and dock are stored per account.
Architecture is split into three parts: omarchyd runs as the user on 127.0.0.1:2021 serving accounts, files, apps, machines and storage; omarchy-server-web serves the web UI on port 7780; and a small root helper handles storage pools, SMB shares, firewall ports and power actions through a single sudoers rule. Apps run in rootless Podman as the user, their ports only admit signed-in browsers, and their setup scripts execute in a networkless sandbox.
Install and first run
Prerequisites: an x86-64 machine already running Omarchy, an internet connection during installation, and optionally /dev/kvm for fast VMs plus blank drives for new storage pools.
-
On the server, log in as your normal user — not with sudo — and run the installer:
curl -fsSL https://raw.githubusercontent.com/TouchWorkStation/omarchy-server/main/install.sh | bash -
The script installs missing dependencies (Node.js, Podman, libvirt, wayvnc and others), builds the project into
~/.local/share/omarchy-server, asks you to create your account in the terminal, and starts two systemd user services that keep running while you are logged out. Add--zfsif you want ZFS pool support. -
Open
http://<server-ip>:7780(or the https variant) in a browser and sign in. -
Re-run the same command or use Settings → Software update to update;
omarchy-server uninstallremoves the software while keeping accounts, apps and machines, and--purgedeletes those too.
Logs are available via journalctl --user -u omarchyd -u omarchy-server-web -f. For development, the repository uses npm install, npm run build and npm test.
Constraints
- Server side requires Omarchy; the app catalog is not offered for arbitrary Linux distributions.
- VMs run under libvirt's per-user session as your user. KVM is needed for full speed; without it machines still run but slowly.
- SMB shares are opened only on the local home LAN addresses; Tailscale is treated as a second network and does not get port 445.
- Local swarm connectors support Linux with systemd across distributions, but desktop sharing needs Hyprland, Sway or other wlroots desktops (wayvnc) or X11 (x11vnc); GNOME and KDE on Wayland cannot be shared yet and require an X11 session.
- Storage pools are only created on blank drives, so drives holding data are never erased.
- The project is independent of Omarchy and not affiliated with it. License is MIT.
HotRepo's take
Omarchy Server is a young repository with no GitHub daily-rank record yet. On the JavaScript new-project list for 2026-11-17 it reported 114 stars and 8 forks, with 10 stars gained in about an hour and a half of tracked growth. That signal is enough to note early interest, but not to judge adoption. The more substantive point is scope: it packages app hosting, per-user VMs, real-desktop remote control and NAS-style storage into one browser surface, with isolation defaults (rootless Podman, signed-in-only app ports, single-use tickets for screens) that matter for anyone exposing a home server.
Written by AI from the project's README, updated . The project's own docs are the source of truth.
You might also like
- typecraft-dev/oma-castA keyboard launcher for Omarchy that ranks apps and Omarchy commands by learned usage, Raycast-style.
- piermark/omarchytvA tiling, keyboard-style home screen that replaces the stock launcher on Android and Google TV, plus webOS experiments.
- prusa3d/prusa-connectSelf-hosted Go server that connects, monitors and controls a fleet of 3D printers over your own network.
- traccar/traccarSelf-hosted GPS tracking server for fleets, assets or personal trackers, connecting 200+ device protocols to one dashboard and API.
- IceWhaleTech/CasaOSTurn a home server into a personal cloud with a web UI for installing Docker apps, managing files and drives.