Getting started
From a fresh Xubuntu to the Ombuntu desktop in one command.
Requirements
| Distribution | Ubuntu 26.04 LTS or a flavour of it. Xubuntu 26.04 is what Ombuntu is built and tested on. Earlier releases do not ship Hyprland. |
|---|---|
| Architecture | amd64 or arm64, detected automatically. On arm64 the launcher (Walker) and its data provider are compiled from source, which adds 10 to 30 minutes. |
| Graphics | Anything with a Mesa Wayland driver: AMD, Intel, or NVIDIA with the open kernel modules. |
| Account | A user with sudo, and internet access. About 250 MB is downloaded. |
| Browser | Optional: a Chromium-based browser (Vivaldi, Chrome, Brave, Edge) makes Omarchy's web apps open as app windows. Firefox is used if none is present. |
Install
curl -fsSL https://ombuntu.org/install.sh | bash
The installer asks for your password once. It installs the Ubuntu packages, fetches upstream Omarchy at a pinned tag into ~/.local/share/omarchy, lays the Ubuntu overlay on top, writes the configuration into ~/.config, applies the Tokyo Night theme with an Ombuntu wallpaper, turns off telemetry, and adds the Ombuntu entry to the login screen. It is safe to run again; it only redoes what changed.
Your XFCE session is not touched. Both are offered at the login screen.
Options
--user-only | Skip the steps that need root (apt, session file) |
--skip-bashrc | Leave ~/.bashrc alone (Ombuntu replaces it; a backup is kept as ~/.bashrc.pre-omarchy) |
--force-config | Overwrite ~/.config files with Omarchy defaults; existing files are saved as *.pre-omarchy |
--keep-telemetry | Leave Canonical and browser telemetry at Ubuntu defaults |
--keep-browser-buttons | Keep browsers' own minimize/maximize/close buttons |
--no-firefox-policy | Do not install the Firefox policy file |
Pass flags to the one-liner with bash -s -- --skip-bashrc. Or clone the repository and run ./install.sh from it.
First login
Log out, pick Ombuntu in the greeter (the small icon next to your name in LightDM), and log in. Super is the Windows key.
| Super + Space | Open any app: start typing its name |
| Super + Return | Terminal |
| Super + Shift + B | Browser |
| Super + W | Close window |
| Super + Alt + Space | Ombuntu menu: themes, setup, install, update, power |
| Super + Shift + K | Beginner cheatsheet |
| Super + K | Every shortcut, searchable |
Themes: Super + Ctrl + Shift + Space. Wallpapers: Super + Ctrl + Space. The full cheatsheet covers windows, workspaces, screenshots and more. Everything Omarchy documents applies; the Omarchy manual is the long version.
Something off? Run the doctor
ombuntu-doctor prints one line per check: the session, duplicate services, tools on the path, keyring flags, privacy files, failed units. Most warnings are fixed by running the installer again. Paste its output when you ask for help.
The installer detects your display scaling (from the panel's size and resolution) and keyboard layout on the first run and writes them to ~/.config/hypr/monitors.conf and input.conf. Both are plain files; edit them if the guess is wrong.
Updating
ombuntu update (or the menu: Update, Omarchy) upgrades Ubuntu packages and re-applies Ombuntu. Running the one-line installer again does the same.