# Ouros X for Linux preview

## Preview status

Ouros X for Linux is a separate native client. It does not include every feature of the Mac app. The Mac walkthroughs, keyboard shortcuts and permission dialogs do not all apply to Linux.

The [Linux preview download](https://ouros.md/download#linux) is an unsigned Arch package for **x86_64 Intel/AMD Omarchy**. Its package version is **0.2.1-1**. There is no published ARM Linux package or package for other distributions in this release. Do not use the Mac disk image on Linux.

This build runs installed on native Omarchy Wayland. It is a preview: Mac feature parity, and account, provider, microphone, audio, OCR and music workflows, are not yet established on Linux.

## Check your system

Run `uname -m`; it must report `x86_64`. The packaged launcher and shortcuts target an Omarchy desktop with **Hyprland 0.56.2 or later**, a user systemd session, Wayland and a compatible Vulkan driver. The staged Wayland and X11 checks above do not establish acceptance of the installed desktop integration.

Pacman checks these declared dependencies from your configured repositories:

```text
alsa-lib bash chromium docx2txt espeak-ng ffmpeg fontconfig freetype2
gcc-libs glib2 glibc gsettings-desktop-schemas hicolor-icon-theme
hyprland>=0.56.2 jq libxcb libxkbcommon libxkbcommon-x11 omarchy openssl
perl pipewire-audio polkit poppler python sqlite systemd tesseract
tesseract-data-eng unrtf unzip util-linux vulkan-driver
vulkan-icd-loader wayland
```

Document import needs `docx2txt`, Perl, unzip, `unrtf` and Poppler. OCR needs Tesseract and its English data. Speech and audio need `espeak-ng`, FFmpeg and PipeWire audio. A window opening does not prove those workflows work.

Keep your existing **Secret Service** provider with a persistent default keyring, and configure your normal desktop **polkit** authentication agent in the same user session. The package includes the exact owner-authentication policy; it does not approve prompts, create or unlock a keyring, sign into a provider or grant account access. Enter your password only into the normal local authentication prompt, not into a chat or website.

## Download and verify

Download **Ouros-X-Linux-0.2.1-1-x86_64.pkg.tar.zst** from the official download page. In the folder containing it, run:

```sh
sha256sum ./Ouros-X-Linux-0.2.1-1-x86_64.pkg.tar.zst
```

The full SHA-256 must be:

```text
7ff8a651e279712d40dbfb94e2db9dc89eb797daa640bdd1ce82cf7ec768ae69
```

The file is 13,137,797 bytes. If the checksum differs, stop and download again. A checksum checks the bytes; it is not a publisher signature. This preview package is unsigned. Do not weaken your package-signature policy to accept it; if your configured policy refuses unsigned local packages, stop rather than bypassing the refusal.

## Install and open

Save your work and close any existing Ouros workspace normally first. If you previously installed a preview manually, read the ownership checks below before proceeding.

```sh
sudo pacman -U ./Ouros-X-Linux-0.2.1-1-x86_64.pkg.tar.zst
systemctl --user daemon-reload
/usr/bin/ouros setup
/usr/bin/ouros invoke
```

Run setup and invoke as your desktop user, never as root. Pacman asks for normal owner authentication and checks dependencies. Do not use `--nodeps`, `--overwrite` or a remote install script to work around a refusal.

The package installs `/usr/bin/ouros`, the complete workspace under `/usr/lib/ouros-gpui/`, an app-menu entry, on-demand user services and the owner-authentication policy. Setup adds **Super+Space** to toggle the workspace and **Super+Shift+F** to open Files. You can also open Ouros from your app menu. Hiding and reopening retains the GUI process; the terminal service has its own lifecycle.

## Keep existing work and resolve ownership conflicts

An older manual installation can already own `/usr/bin/ouros` or `/usr/lib/ouros-gpui/`. A user-local launcher, desktop entry or systemd unit can also shadow the package. Do not force installation over those files or delete them without reviewing who owns and uses them.

Before changing an existing installation, inspect:

```sh
command -v ouros
pacman -Qo /usr/bin/ouros /usr/lib/ouros-gpui/bin/ouros-gpui
systemctl --user show ouros-gpui.service -p FragmentPath -p DropInPaths
systemctl --user show ouros-gpui-sessiond.service -p FragmentPath -p DropInPaths
/usr/bin/ouros --identity
```

A path reported as unowned is not permission to overwrite it. Packaged services should resolve to `/usr/lib/systemd/user/` without unreviewed overrides. `ouros setup` refuses overridden services. Use the earlier installation's managed updater, or deliberately reconcile its launchers, user services and menu entry before continuing. Preserve notes, settings, credentials, edited files and live terminal sessions. Do not unload compositor integration or delete user configuration as a shortcut.

Preview updates are manual. Do not stop the terminal service just to update or close the GUI. If there is no compatible package for your system, keep using the version that already works for you. For Mac installation instead, see [Install Ouros X on Mac](/docs/ouros-x/mac-installation).