INSTALL / EXISTING OMARCHY
One command.
Your server is ready.
Already running Omarchy? Install My Own Data Center directly onto your existing system.
curl -fsSL https://raw.githubusercontent.com/TouchWorkStation/omarchy-server/main/install.sh | bashRun on the host computer as your normal user, not through sudo bash. The installer requests sudo only when needed. Review the installation script ↗ before running it.
Before you begin
- An x86-64 computer with an existing Omarchy installation (Arch Linux + Hyprland).
- An internet connection for downloading packages and building the web interface.
- Node.js 20 or newer, systemd, and pacman; the installer handles missing packages.
- For accelerated VMs: KVM support and /dev/kvm. For new storage pools: extra blank drives.
No standalone operating-system image is needed. Ubuntu and Debian are not supported installation targets for this guide.
- 01
Start with Omarchy
Keep your existing Omarchy desktop. If you haven’t installed it yet, follow the official Omarchy instructions ↗.
- 02
Run the command
Open the terminal on your Omarchy machine and paste the command above. It installs dependencies, builds the web interface, configures services, and asks you to create your account in the terminal.
- 03
Open your server
Visit
http://YOUR-SERVER-IP:7780from a browser on your local network. Replace YOUR-SERVER-IP with your host’s actual address and sign in with the account you just created.
Updating
Run the same installation command again on the host. The current installer preserves your account, sessions, and files. The current source also implements Settings → Software update; if it fails, use the host command and inspect the logs.
Advanced: optional ZFS installation
ZFS uses AUR packages zfs-utils and zfs-dkms and needs yay, matching kernel headers, and a compatible OpenZFS kernel module. The installer may require a system update and reboot. Compatibility depends on your current kernel.
curl -fsSL https://raw.githubusercontent.com/TouchWorkStation/omarchy-server/main/install.sh | bash -s -- --zfsUninstalling
A complete uninstall command is not documented in the current repository. Factory reset is not an uninstall procedure and can remove data. Review the current source or ask in GitHub issues before removing services or files.
Installation helpServices and logs
Two systemd user services power the server: omarchyd on localhost port 2021 and omarchy-server-web on port 7780. The installer enables user lingering so they can keep running after logout. Desktop sharing is separate and requires an active graphical session.
journalctl --user -u omarchyd -u omarchy-server-web -fKeep remote access deliberate.
Start on your local network. HTTP is not encrypted. The product supports HTTPS on the same port with its own certificate authority, which must be trusted on your devices. Do not simply expose port 7780 to the public internet; use a trusted private network or VPN and understand your firewall configuration. Cloudflare Tunnel requires your own tunnel and access configuration; it is not automatically created by this installer.
