Linux Distribution and Packaging

Jump to bottom

Marvin edited this page May 5, 2026 · 1 revision

Linux Distribution and Packaging

Supported Targets

Primary distro families for gamers and IT users:

Debian/Ubuntu (.deb)
Fedora/RHEL (.rpm)
Arch (.pkg.tar.zst)
Universal fallback (.tar.gz)

Scripts

scripts/linux/build-avalonia-packages.sh
scripts/linux/build-avalonia-packages.ps1

nfpm Installation (Required)

Use the GoReleaser apt repository:

echo 'deb [trusted=yes] https://repo.goreleaser.com/apt/ /' | sudo tee /etc/apt/sources.list.d/goreleaser.list
sudo apt update
sudo apt install nfpm

Flatpak

Manifest: scripts/linux/flatpak/com.gregframework.gregModmanager.yml
Launcher: scripts/linux/flatpak/gregmodmanager-flatpak-launcher.sh

CI/CD

Workflow: .github/workflows/avalonia-linux-packages.yml

Builds Linux artifacts
Uploads packages as workflow artifacts
Publishes a runtime container to GHCR

Notes

Desktop launcher entry is included.
Package dependencies are explicitly declared.
Flatpak is optional but recommended for broad desktop compatibility.
Linux package build expects nfpm in PATH.