Every release runs install → nginx -t pass → plugin load → admin healthz=200 → challenge served (http=403) on each distro below:
distro
package
nginx (tested version)
status
AlmaLinux 10 / Rocky 10 / RHEL 10
rpm
1.26.3
verified
AlmaLinux 9 / Rocky 9 / RHEL 9
rpm
1.20.1
verified
AlmaLinux 8 / Rocky 8 / RHEL 8
rpm
1.14.1
verified
CentOS 7 / RHEL 7 (EOL 2024-06)
rpm
1.20.1 (EPEL)
verified
CentOS 6 / RHEL 6 (EOL 2020-11)
rpm
1.10.3 (EPEL)
verified
Debian 13
deb
1.26.3
verified
Debian 12
deb
1.22.1
verified
Ubuntu 26.04
deb
1.28.3
verified
Ubuntu 24.04
deb
1.24.0
verified
Ubuntu 22.04
deb
1.18.0
verified
Alpine 3.x
apk
1.26.3
verified
Same package format (install worth trying)
Derivatives that accept the same rpm / deb / apk packages will often install, but they are not in our CI, so the outcome isn't guaranteed. Reports either way are welcome on the
issue tracker:
distro
format
notes
openSUSE Leap / Tumbleweed
rpm
Same package lineage. AppArmor (not SELinux) — confinement may need extra tuning.
Debian derivative without systemd. Ships sysvinit / openrc init scripts.
Raspbian / Raspberry Pi OS
deb (arm64)
Works on a 64-bit OS via the arm64 packages (the native plugin ships arm64 too).
Not currently supported
Distros below are out of scope for now — install attempts won't work:
environment
reason
Arch Linux
pacman .pkg.tar.zst. No AUR package yet (contributors welcome).
Gentoo
portage ebuild. Same — no recipe yet.
NixOS
nix derivation. flake / nixpkgs entry is a future candidate.
FreeBSD / OpenBSD
pkg(8). The nginx ABI differs from Linux glibc; needs a separate build.
macOS
Not a production server target (docker run with a supported Linux image works for local dev).
Windows / WSL
nginx for Windows is ABI-incompatible. WSL distros work using the matching Linux instructions above.
Architectures
unmask supports both x86_64 (amd64) and aarch64 (arm64). Every distro package (main / nginx plugin / web integration) is built for both, and verified on real Ampere arm64 hardware (native + forward-auth + JA4 extraction).