Files
uur/docs/distribution.md
T
2026-09-05 13:04:29 +08:00

2.9 KiB

Package installation

Choose the package format native to the system. Every format installs the same Rust supervisor, Wine adapters, PipeWire helper, desktop entry, icon, and uinput integration files. sudo, doas, or another privilege frontend may be needed for system-wide package installation.

Arch Linux

# AUR
paru -S uur

# Downloaded release package
sudo pacman -U ./uur-0.1.0-1-x86_64.pkg.tar.zst

Debian, Ubuntu, and derivatives

sudo apt install ./uur_0.1.0_amd64.deb

The same release artifact covers Debian, Ubuntu, Linux Mint, Pop!_OS, KDE neon, Zorin OS, elementary OS, Kali Linux, MX Linux, TUXEDO OS, and compatible derivatives.

Fedora, RHEL, and openSUSE families

sudo dnf install ./uur-0.1.0-1.x86_64.rpm

# openSUSE
sudo zypper install ./uur-0.1.0-1.x86_64.rpm

This format also covers Fedora derivatives and RPM systems whose repositories provide the declared Wine, GLib, PipeWire, and portal dependencies.

Portable archive

The portable archive targets conventional glibc/FHS systems:

sudo tar --zstd -C / -xf ./uur-0.1.0-linux-x86_64.tar.zst

Nix and NixOS

nix build
nix run . -- doctor

The flake includes a package, application, development shell, lock file, and NixOS module. See Nix and NixOS.

Alpine Linux and musl

packaging/alpine/APKBUILD builds an x86_64 musl package from a tagged source archive. The container recipe runs the same Rust, MinGW, and PipeWire builds:

docker build -f packaging/alpine/Dockerfile .

Alpine edge provides native x86_64 Wine, PulseAudio/ALSA Wine drivers, PipeWire, desktop portals, Rust, and the MinGW-w64 toolchain.

cd packaging/alpine
abuild checksum
abuild -r
sudo apk add ~/packages/*/x86_64/uur-*.apk

Other package ecosystems

Gentoo, Funtoo, Void Linux, Slackware, Solus, Clear Linux, ALT Linux, Exherbo, Mageia, OpenMandriva, PCLinuxOS, Venom Linux, and other FHS/glibc systems can install the portable release archive or build from source. Their native recipe can call packaging/stage.sh after the three standard builds; the staged tree is shared with pacman, deb, rpm, APK, and the portable archive.

GNU Guix can wrap the same source build and staged tree. Flatpak and Snap need manifests granting Wine execution, session D-Bus, PipeWire, and input access.

Source installation for one user

cargo build --release --locked
./hook/build.sh
./capture/build.sh
./scripts/install-user.sh

This installs under ~/.local by default. It requires Rust, a native C compiler, PipeWire development files, pkg-config, and the MinGW-w64 x86_64 toolchain.

Required first run

Package installation does not implicitly accept NetEase's EULA or download the official client. Complete the setup explicitly:

uur doctor
uur setup --accept-eula
uur run

See Platform support and usage for desktop-session and portal requirements.