Ombuntu

FAQ

Short answers to the questions that come up.

What is Ombuntu, in one sentence?

A pre-configured, keyboard-driven Hyprland desktop for Ubuntu 26.04 that is secure and private by default and installs next to the desktop you already have.

What is off by default?

Telemetry to Canonical and the browser vendors; remote code (no curl | sh installers, plugin hooks, menu extensions or cloned themes); unverified downloads (everything is checksummed, keys are fingerprint-checked, upstreams are commit-pinned); and security shortcuts (passwordless sudo, autologin, remembered screen-share permissions, plain-text browser password storage). The privacy and security page lists each item with the file behind it and how to reverse it.

Is this Omarchy?

It is built on it. Upstream Omarchy is installed unchanged at a pinned commit, and Ombuntu's adaptations replace what Arch has and Ubuntu does not, disables the plugin surface, and adds the security and privacy defaults. The menu, themes, bar, launcher, lock screen and keybindings are Omarchy's.

Why not just install Arch?

Some people want the Omarchy experience on the Ubuntu they already run, with apt, Ubuntu's kernel and driver support, and their existing XFCE session as a fallback. Ombuntu is for them.

Does it replace Xubuntu's desktop?

No. XFCE stays installed and untouched. You choose Ombuntu or Xubuntu Session at the login screen.

Why does the command say omarchy if this is Ombuntu?

Everything Ombuntu adds is named Ombuntu: the session, branding, wallpapers, the ombuntu command. The upstream engine keeps its omarchy-* command names because its 280-plus scripts call each other by them. ombuntu and omarchy run the same dispatcher.

I see two top bars, or two error popups at login.

Ubuntu's waybar and hypridle packages enable user services globally, which duplicated what Omarchy starts. Run the installer again; it masks them.

Signal says "file is not a database". My browser lost its passwords.

Chromium and Electron apps only use the GNOME keyring on desktops they recognise; under Hyprland they fall back to plain-text storage and cannot decrypt what was saved under XFCE. Ombuntu launches them with the keyring backend selected. Use the launcher entries or the Super key bindings, not a bare command.

Firefox says it is already running after I switch from XFCE.

The XFCE session left it running. pkill -f /snap/firefox, then open it again. Rebooting between desktops avoids this.

Where are the Omarchy plugins, hooks and extra themes?

Disabled on purpose. Hooks, menu extensions and remote theme installs execute arbitrary code with your user rights on everyday actions. Use the bundled themes, or copy a theme you have reviewed into ~/.config/omarchy/themes/ by hand.

Why no minimize, maximize or close buttons in the browser?

Hyprland is a tiling compositor and draws no title bars. Ombuntu sets browsers to system decorations so their own buttons disappear; Super + W closes, Super + F goes full screen. ombuntu-browser-decorations on brings the buttons back.

Does it work on arm64?

Yes. Ubuntu builds the whole desktop for arm64. Walker and Elephant have no arm64 releases, so the installer compiles them from source, which takes 10 to 30 minutes.

How do I update?

ombuntu update, the menu's Update entry, or run the one-line installer again. Ubuntu packages come from apt; Ombuntu re-applies its adaptations.

An Install menu entry says "not packaged for Ubuntu by Ombuntu".

That is a deliberate stop, not a bug. The entry's software has no apt package, vendor repository or checksummed download, and Ombuntu does not pipe remote scripts into a shell. The message says where to get it by hand.

Where are Spotify, Obsidian, Typora?

Omarchy preinstalls them on Arch. Ombuntu offers them under the menu's Install, Apps, from the official snaps and vendor apt repositories. Once installed, Omarchy's shortcuts for them (Super + Shift + M, O, W) work. 1Password is not offered; Bitwarden is, under Install, Service.

Can I use my fingerprint reader or a security key?

Yes: Setup, Security in the menu enrols a fingerprint (fprintd) or registers a FIDO2 key (pam_u2f, PIN plus touch) for sudo, polkit and the lock screen, using Ubuntu's PAM layout. The password always remains as a fallback.

Does hibernation work?

On an ext4 root, yes: Setup, System, Enable Hibernate creates a swapfile the size of RAM (or reuses Ubuntu's), sets the resume parameters for GRUB and the initramfs, and makes suspend hand over to hibernate after two hours.

Hotel Wi-Fi does not show its login page.

Ombuntu turns off NetworkManager's connectivity probe to Canonical, which is what normally detects captive portals. Open any plain http:// page (for example http://neverssl.com) and the login page appears. To restore automatic detection, delete /etc/NetworkManager/conf.d/99-ombuntu-no-connectivity-check.conf and reload NetworkManager.

How do I add an app or a website to the launcher?

For a website, press Super + Alt + Space and choose Install, then Web App. It asks for a name and a URL, grabs the site's icon, and the site opens in its own window with no tabs or address bar. From a terminal the same thing is ombuntu-webapp-install "Name" https://example.com, and ombuntu-webapp-remove "Name" takes it away again.

For a program you installed by hand that never showed up in the launcher, it is missing its desktop entry. Some programs can add their own: Tor Browser, for instance, registers itself with ./start-tor-browser.desktop --register-app run from the folder it lives in. Otherwise put a .desktop file in ~/.local/share/applications/.

A web app I deleted keeps coming back.

The ones Omarchy ships (WhatsApp, ChatGPT, YouTube, X, GitHub, Figma, Discord, Zoom, Google Photos, Contacts, Messages and Maps) are re-created every time you run ombuntu update or the installer, so deleting one lasts until the next update. Web apps you created yourself are never touched.

The exception is duplicates: if you install the real application, Ombuntu retires the matching web app on the next update rather than listing the same name twice. Install the ChatGPT desktop app and the ChatGPT web app stops coming back.

How do I check my install is healthy?

ombuntu-doctor. One line per check; re-running the installer fixes most warnings.

Is Ombuntu affiliated with Ubuntu or Omarchy?

No. It is an independent community project. Ubuntu and Xubuntu are Canonical trademarks; Omarchy belongs to DHH and contributors.