GUIDE / OMARCHY SERVER
Troubleshooting
Diagnose installation, service, network, and optional-feature issues.
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.
systemctl --user status omarchyd omarchy-server-webRead 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.
journalctl --user -u omarchyd -u omarchy-server-web -fAn 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.
curl -fsSL https://raw.githubusercontent.com/TouchWorkStation/omarchy-server/main/install.sh | bashDesktop 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.
