GUIDE / MY OWN DATA CENTER

Troubleshooting

Diagnose installation, service, network, and optional-feature issues.

Verified against the public source · November 14, 2026Read current source ↗

The installer rejects your system

Run it on your Omarchy host as a normal user, not root. The installer checks for pacman and systemd and needs Node.js 20 or newer. Ubuntu and Debian hosts are not covered by these instructions.

The dashboard does not open

Check the host address and port 7780, that both devices are on the same network, and that the web and backend services are running. The installer configures UFW when present; another firewall or network can still block access.

host terminal
systemctl --user status omarchyd omarchy-server-web

Read service logs

Use the host terminal to inspect the backend and web logs. Remove credentials, session information, and personal paths before sharing output in a public issue.

host terminal
journalctl --user -u omarchyd -u omarchy-server-web -f

An update fails

Run the installation command again on the host and inspect its output. The current source implements in-app updates, but local package, network, and build failures can still prevent completion.

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

Desktop is unavailable

Make sure a Hyprland graphical session is active. Desktop sharing does not keep running after graphical logout. Check the desktop service logs for wayvnc failures.

ZFS fails to load

Check that your running kernel and installed headers match. A reboot may be needed after a kernel update. OpenZFS may not yet support the newest kernel; inspect DKMS output and the repository before retrying.

Get help or remove the installation

Report reproducible bugs through GitHub issues. Include the version, host environment, and redacted logs. A verified complete uninstall command is not provided here; consult the current repository rather than deleting data or service files blindly.