Install AxoSyslog

Install AxoSyslog on Debian, Ubuntu, RHEL, Fedora, or AlmaLinux, run it with Docker, Podman, or Helm, upgrade to a newer version, or upgrade from syslog-ng.

This chapter explains how to install AxoSyslog on various platforms.

Cloud-ready syslog-ng images

AxoSyslog provides cloud-ready images. These images differ from the upstream syslog-ng images, because:

  • They’re based on Alpine Linux, instead of Debian testing for reliability and smaller size (thus smaller attack surface).
  • They incorporate cloud-native features and settings, such as the Kubernetes source.
  • They incorporate container-level optimizations for better performance and improved security. For example, they use an alternative malloc library.
  • They support the ARM architecture.

The AxoSyslog images support the following architectures:

  • amd64
  • arm/v7
  • arm64

Install AxoSyslog

Upgrade AxoSyslog

To upgrade an existing AxoSyslog installation to a newer version (packages, container images, or the Helm chart), see Upgrade AxoSyslog to a newer version.

Upgrade syslog-ng to AxoSyslog

If you’re already using syslog-ng, you can upgrade your existing syslog-ng deployments to AxoSyslog in a matter of minutes. For details, see Upgrade syslog-ng to AxoSyslog.

Forward Windows logs

Axoflow provides a custom OpenTelemetry Collector distribution that you can use to collect logs on Windows hosts and forward them to AxoSyslog. For details, see Forward Windows logs.


Install AxoSyslog with Podman and systemd

Install AxoSyslog on Debian/Ubuntu

Install AxoSyslog on RHEL/Fedora/AlmaLinux

Install AxoSyslog with Helm

Install AxoSyslog on Kubernetes with the Helm chart, as a collector, an aggregator, or both.

Install AxoSyslog with Podman

Install AxoSyslog with Docker

AxoSyslog on macOS

Build AxoSyslog from source on macOS with Homebrew dependencies, and see which modules the macOS build leaves out.

Upgrade AxoSyslog to a newer version

Upgrade an existing AxoSyslog installation from packages, container images, or the Helm chart, update the configuration version, and roll back if needed.

Upgrade syslog-ng to AxoSyslog

Forward Windows logs

Last modified October 2, 2026: Adds an upgrade axosyslog page (7fbe98d3)