INSTALL / EXISTING OMARCHY

One command.
Your server is ready.

Already running Omarchy? Install Omarchy Server directly onto your existing system.

omarchy ~
curl -fsSL https://raw.githubusercontent.com/TouchWorkStation/omarchy-server/main/install.sh | bash

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

  1. 01

    Start with Omarchy

    Keep your existing Omarchy desktop. If you haven’t installed it yet, follow the official Omarchy instructions ↗.

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

  3. 03

    Open your server

    Visit http://YOUR-SERVER-IP:7780 from 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.

optional / ZFS
curl -fsSL https://raw.githubusercontent.com/TouchWorkStation/omarchy-server/main/install.sh | bash -s -- --zfs

Uninstalling

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 help

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

service logs
journalctl --user -u omarchyd -u omarchy-server-web -f

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