Omnibus Firezone currently supports the following platforms:
|AmazonLinux 2||Fully-supported||See AmazonLinux 2 Notes|
|CentOS 7||Fully-supported||See CentOS 7 Notes|
|CentOS 8||Fully-supported||See CentOS 8 Notes|
|CentOS Stream 9||Fully-supported||Works as-is|
|Red Hat Enterprise Linux 7||Fully-supported||See RHEL 7 Notes|
|Red Hat Enterprise Linux 8||Fully-supported||See RHEL 8 Notes|
|Red Hat Enterprise Linux 9||Fully-supported||See RHEL 9 Notes|
|Debian 10||Fully-supported||See Debian 10 Notes|
|Debian 11||Fully-supported||Works as-is|
|Fedora 33||Fully-supported||See Fedora Notes|
|Fedora 34||Fully-supported||See Fedora Notes|
|Fedora 35||Fully-supported||See Fedora Notes|
|Ubuntu 18.04||Fully-supported||See Ubuntu 18.04 Notes|
|Ubuntu 20.04||Fully-supported||Works as-is|
|Ubuntu 22.04||Fully-supported||Works as-is|
|openSUSE Leap 15.3||Fully-supported||See openSUSE Notes|
If your distro isn't listed here please try using a package for the closest distro first. For example, since Raspberry Pi OS is based on Debian, try using the Debian Firezone package.
If that doesn't work, please open an issue and let us know. New distros are being supported on a regular basis and there's a good chance yours will be added soon.
Note that we only support RPM and DEB based packaging systems. Others, like Arch Linux are currently being investigated in this issue.
AmazonLinux 2 notes
Kernel upgrade required:
sudo amazon-linux-extras install -y kernel-5.10
CentOS 7 notes
Kernel upgrade to 5.6+ required. To upgrade to the latest mainline kernel and select it as the default boot kernel:
sudo rpm --import https://www.elrepo.org/RPM-GPG-KEY-elrepo.org
sudo yum install -y https://www.elrepo.org/elrepo-release-7.el7.elrepo.noarch.rpm
sudo yum install -y elrepo-release
sudo yum --enablerepo=elrepo-kernel install -y kernel-ml
sudo grub2-set-default 0
sudo grub2-mkconfig -o /boot/grub2/grub.cfg
CentOS 8 notes
The WireGuard kernel module needs to be installed:
yum install elrepo-release epel-release
yum install kmod-wireguard
RHEL 7 notes
Red Hat Enterprise Linux is binary compatible with CentOS, so the Firezone package for CentOS 7 should work just fine for RHEL 7. You'll still need to upgrade your kernel to 5.6+ however. To do so, follow the steps for CentOS 7 Notes above.
RHEL 8 notes
Red Hat Enterprise Linux is binary compatible with CentOS, so the Firezone package for CentOS 8 should work just fine for RHEL 8. You'll still need to install the WireGuard kernel module, however. See CentOS 8 Notes above.
RHEL 9 notes
Use the package for CentOS 9.
On fresh Fedora installations you'll probably need to install a cron
implementation to support the logrotate functionality, otherwise
you may receive errors about a missing
yum install cronie-anacron
Ubuntu 18.04 notes
Kernel upgrade to 5.4+ required:
sudo apt install linux-image-generic-hwe-18.04
Debian 10 notes
Kernel upgrade to 5.6+ required. See this guide for an example.
Firezone requires the
setcap utility, but some recent openSUSE releases may
not have it installed by default. To fix, ensure
libcap-progs is installed:
sudo zypper install libcap-progs