Install AxoSyslog on RHEL/Fedora/AlmaLinux

You can install AxoSyslog 4.8 and newer on your RPM-based system using Axoflow’s RPM packages. AxoSyslog is a drop in replacement for the syslog-ng RPM package, all the AxoSyslog binaries and configuration files are stored at the same place on your system.

The following x86-64 distributions are supported:

• Red Hat Enterprise Linux (RHEL) 9 / AlmaLinux 9
• Red Hat Enterprise Linux (RHEL) 8 / AlmaLinux 8
• Fedora 40
• Fedora 39

We are working on providing an RPM repository for the upcoming releases.

(The packages for AlmaLinux probably work for Rocky Linux as well, but we haven’t tested it.)

Which package to install?

AxoSyslog supports many features. Some of these, like specific sources and destinations require additional packages that you need only if you’re actually using the specific destination. Therefore, AxoSyslog has a number of modules that you can install as a separate package if you need the particular feature. For example, to use the gRPC-based destinations (like loki() or opentelemetry()), install the axosyslog-grpc-* package. For HTTP-based destinations like elasticsearch-http() or sumologic-http(), you need the axosyslog-http-* package.

Usually, you install the base package axosyslog-<version-number>.<distro>.x86_64.rpm, and the packages of specific modules that you want to use. We also provide debuginfo packages for every module, but you only need these in certain troubleshooting scenarios.

Steps

To install AxoSyslog on RedHat Enterprise Linux 9 or AlmaLinux 9, complete the following steps. The instructions for AlmaLinux probably work for Rocky Linux 9 as well, but we haven’t tested it.

1. Run the following commands to enable the EPEL repositories for your distribution. This is needed to install some dependencies of AxoSyslog. (For RHEL 8 and compatible distributions, use these instructions.)

   • RHEL 9:

     sudo subscription-manager repos --enable codeready-builder-for-rhel-9-$(arch)-rpms
     sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
     

   • AlmaLinux 9:

     sudo dnf install epel-release
     sudo dnf config-manager --set-enabled crb
     

2. Download and extract the release tarball for your distribution, for example, on Almalinux 9:

   wget https://github.com/axoflow/axosyslog/releases/download/axosyslog-4.9.0/rpm-almalinux-9.tar.gz
   tar -xvzf rpm-almalinux-9.tar.gz
   cd rpm-almalinux-9/
   

3. Install AxoSyslog:

   sudo yum install ./axosyslog-*
   

   Install other packages for the modules you want to use as needed. For example, to use the gRPC-based destinations (like loki() or opentelemetry()), install the axosyslog-grpc-* package. For HTTP-based destinations like elasticsearch-http() or sumologic-http(), you need the axosyslog-http-* package.

4. Enable syslog-ng.

   sudo systemctl enable syslog-ng
   sudo systemctl start syslog-ng
   

5. (Optional) If you don’t want to run other log collectors on the host, you can delete the existing one (which is rsyslog by default):

   sudo yum remove rsyslog.x86_64
   

Install AxoSyslog on Fedora

1. Download the release tarball for your distribution, for example, on Fedora 40:

   wget https://github.com/axoflow/axosyslog/releases/download/axosyslog-4.9.0/rpm-fedora-40.tar.gz
   tar -xvzf rpm-fedora-40.tar.gz
   cd rpm-fedora-40/
   

2. Install AxoSyslog:

   sudo yum install ./axosyslog-4.9.0.2*
   

   Install other packages for the modules you want to use as needed. For example, to use the gRPC-based destinations (like loki() or opentelemetry()), install the axosyslog-grpc-* package. For HTTP-based destinations like elasticsearch-http() or sumologic-http(), you need the axosyslog-http-* package.

3. Enable syslog-ng.

   sudo systemctl enable syslog-ng
   sudo systemctl start syslog-ng
   

4. (Optional) If you don’t want to run other log collectors on the host, you can delete the existing one (which is rsyslog by default):

   sudo yum remove rsyslog.x86_64
   

Using AxoSyslog

After you’ve installed AxoSyslog, you can configure it just like syslog-ng, using the same configurations files (/etc/syslog-ng/syslog-ng.conf by default). For details, see the Quick-start guide.

Getting help

If you run into any issues while installing or configuring AxoSyslog, or you have any questions, you can find us on our Discord server.