Linux packages by distribution

Gnomad ships three official Linux formats from Tauri:

Official downloads: GitHub Release v0.1.0-alpha (.deb, .rpm, AppImage) or the project site.

CI also builds on every push to main — backup artifacts under Actions → Build.

Wayland vs X11

Gnomad detects XDG_SESSION_TYPE at runtime. On Wayland, use left-click on the tray icon to open the menu. Settings shows a hint when Wayland is detected. Optional context tools: wl-paste (Wayland), xdotool/xclip (X11).

Local build (on Ubuntu 22.04+ or Debian 12+):

npm run tauri:build:linux          # deb + rpm + AppImage
npm run tauri:build:linux:deb      # Debian/Ubuntu only
npm run tauri:build:linux:rpm      # Fedora/RHEL family only
npm run tauri:build:linux:appimage # universal binary only

Outputs:

• src-tauri/target/release/bundle/deb/
• src-tauri/target/release/bundle/rpm/
• src-tauri/target/release/bundle/appimage/

Debian / Ubuntu / Mint / Pop!_OS

sudo apt install ./gnomad_*_amd64.deb

Or:

sudo dpkg -i gnomad_*_amd64.deb
sudo apt-get install -f   # fix missing dependencies if needed

Dependencies (installed automatically): WebKitGTK 4.1, GTK 3, Ayatana or legacy app indicator (system tray).

Remove:

sudo apt remove gnomad

Fedora / RHEL / Rocky / AlmaLinux

sudo dnf install ./gnomad-*-1.x86_64.rpm

Dependencies: webkit2gtk4.1, gtk3, libappindicator-gtk3 (tray).

On Fedora 40+ you may need Ayatana instead of legacy indicator; if install fails, install tray support manually:

sudo dnf install libayatana-appindicator-gtk3

Remove:

sudo dnf remove gnomad

openSUSE / SUSE

sudo zypper install ./gnomad-*-1.x86_64.rpm

Same RPM as Fedora family.

Arch Linux / Manjaro

Tauri does not produce native .pkg.tar.zst bundles. Use the AppImage:

chmod +x gnomad_*_amd64.AppImage
./gnomad_*_amd64.AppImage

Optional: move to ~/Applications or /opt and add a .desktop file.

For AUR maintainers, package the AppImage or release .deb via debtap — not maintained in this repo.

Universal (AppImage)

Works on most glibc-based x86_64 distros without a package manager install step:

chmod +x gnomad_*_amd64.AppImage
./gnomad_*_amd64.AppImage

Integrate with the desktop (optional):

./gnomad_*_amd64.AppImage --appimage-extract
# or use AppImageLauncher / Gear Lever on some desktops

Note: Build on Ubuntu 22.04 / Debian 12 (or our CI) so glibc stays compatible with older systems. Building on Fedora-only may produce RPMs that won’t install on Debian and vice versa — that’s why we ship both .deb and .rpm plus AppImage.

Snap / Flatpak

Optional community packaging (not in default CI release matrix):

GitHub Actions: Packaging workflow (workflow_dispatch) for CI-built flatpak/snap artifacts.

For most users, prefer deb, rpm, or AppImage from Releases.

ARM64 (Raspberry Pi, ARM laptops)

Official CI artifacts include x86_64 (Ubuntu 22.04) and ARM64 (Ubuntu 24.04 ARM runner): .deb and .AppImage on both; .rpm on x86_64 only.

To cross-compile locally on a Debian/Ubuntu x86_64 host:

rustup target add aarch64-unknown-linux-gnu
sudo apt install gcc-aarch64-linux-gnu libwebkit2gtk-4.1-dev:arm64
export PKG_CONFIG_SYSROOT_DIR=/usr/aarch64-linux-gnu/
npm run tauri:build:linux:arm64
# or:
npm run tauri:build:linux -- --target aarch64-unknown-linux-gnu

AppImage cross-build for ARM is slower; prefer .deb on ARM boards running Debian/Ubuntu.

Troubleshooting

See also BUILD_PLATFORMS.md.