netdata/packaging/DISTRIBUTIONS.md

Netdata distribution support matrix

In the following table we've listed Netdata's official supported operating systems. We detail the distributions, flavors, and the level of support Netdata is currently capable to provide.

The following table is a work in progress. We have concluded on the list of distributions that we currently supporting and we are working on documenting our current state so that our users have complete visibility over the range of support.

Legend:

• Version: Operating system version supported
• Family: The family that the OS belongs to
• CI: Smoke Testing: Smoke testing has been implemented on our CI, to prevent broken code reaching our users
• CI: Testing: Testing has been implemented to prevent broken or problematic code reaching our users
• CD: Continuous deployment support has been fully enabled for this operating system
• .DEB: We provide a .DEB package for that particular operating system
• .RPM: We provide a .RPM package for that particular operating system
• Installer: Running netdata from source, using our installer, is working for this operating system
• Kickstart: Kickstart installation is working fine for this operating system
• Kickstart64: Kickstart static64 installation is working fine for this operating system
• Community: This operating system receives community support, such as packaging maintainers, contributors, and so on

AMD64 Architecture

Version	Family	CI: Smoke testing	CI: Testing	CD	.DEB	.RPM	Installer	Kickstart	Kickstart64	Community
14.04.6 LTS (Trusty Tahr)	Ubuntu	✗	?	✗	✗	N/A	✔	✔	✔	?
16.04.6 LTS (Xenial Xerus)	Ubuntu	✔	?	✔	✔	N/A	✔	✔	✔	?
18.04.2 LTS (Bionic Beaver)	Ubuntu	✔	?	✔	✔	N/A	✔	✔	✔	?
19.10 (Eoan Ermine) Latest	Ubuntu	✔	?	✔	✔	N/A	✔	✔	✔	?
Debian 8 (Jessie)	Debian	✔	?	✔	✔	N/A	✔	✔	✔	?
Debian 9 (Stretch)	Debian	✔	?	✔	✔	N/A	✔	✔	✔	?
Debian 10 (Buster)	Debian	✔	?	✔	✔	N/A	✔	✔	✔	?
Versions 6.x	RHEL	✗	?	✗	N/A	✔	✔	✔	✔	?
Versions 7.x	RHEL	✔	?	✔	N/A	✔	✔	✔	✔	?
Versions 8.x	RHEL	?	?	?	N/A	✗	?	?	✔	?
Fedora 30	Fedora	✔	?	✔	N/A	✔	✔	✔	✔	?
Fedora 31	Fedora	✔	?	✔	N/A	✔	✔	✔	✔	?
CentOS 6.x	Cent OS	✗	?	✗	N/A	✗	✔	✔	✔	?
CentOS 7.x	Cent OS	✔	?	✔	N/A	✔	✔	✔	✔	?
CentOS 8.x	Cent OS	?	?	?	N/A	✗	?	?	✔	?
openSUSE Leap 15.1	openSUSE	✔	?	✔	N/A	✔	✔	✔	✔	?
openSUSE Tumbleweed	openSUSE	✔	?	?	N/A	✗	✔	?	✔	?
SLES 11	SLES	?	?	?	N/A	✗	?	?	✔	?
SLES 12	SLES	?	?	?	N/A	✗	?	?	✔	?
SLES 15	SLES	?	?	?	N/A	✗	?	?	✔	?
Alpine	Alpine	✔	?	✗	N/A	N/A	✔	✔	✔	?
Arch Linux (latest)	Arch	✔	?	✗	N/A	✗	✔	✔	✔	?
All other linux	Other	✗	?	?	✗	✗	?	?	✔	?

x86 Architecture

Version	Family	CI: Smoke testing	CI: Testing	CD	.DEB	.RPM	Installer	Kickstart	Kickstart64	Community
14.04.6 LTS (Trusty Tahr)	Ubuntu	✗	?	✗	✗	N/A	✔	✔	✗	?
16.04.6 LTS (Xenial Xerus)	Ubuntu	✗	?	✔	✔	N/A	✔	✔	✗	?
18.04.2 LTS (Bionic Beaver)	Ubuntu	✗	?	✔	✔	N/A	✔	✔	✗	?
19.10 (Enoan Ermine) Latest	Ubuntu	✗	?	✔	✔	N/A	✔	✗	✔	?
Debian 8 (Jessie)	Debian	✗	?	✔	✔	N/A	✔	✔	✗	?
Debian 9 (Stretch)	Debian	✗	?	✔	✔	N/A	✔	✔	✗	?
Debian 10 (Buster)	Debian	✗	?	✔	✔	N/A	✔	✔	✗	?
Versions 6.x	RHEL	✗	?	✗	N/A	✔	✔	✔	✗	?
Versions 7.x	RHEL	✗	?	✔	N/A	✗	✔	✔	✗	?
Versions 8.x	RHEL	?	?	?	N/A	✗	?	?	✔	?
Fedora 30	Fedora	✗	?	✔	N/A	✗	✔	✔	✗	?
Fedora 31	Fedora	✗	?	✗	N/A	✗	✗	✗	✗	?
CentOS 6.x	Cent OS	✗	?	✗	N/A	✗	✔	✔	✗	?
CentOS 7.x	Cent OS	✗	?	✔	N/A	✗	✔	✔	✗	?
CentOS 8.x	Cent OS	?	?	?	N/A	✗	?	?	✔	?
openSUSE Leap 15.1	openSUSE	✗	?	✔	N/A	✗	✔	✔	✗	?
openSUSE Tumbleweed	openSUSE	✗	?	?	N/A	✗	✔	?	✗	?
SLES 11	SLES	?	?	?	N/A	✗	?	?	✗	?
SLES 12	SLES	?	?	?	N/A	✗	?	?	✗	?
SLES 15	SLES	?	?	?	N/A	✗	?	?	✗	?
Alpine	Alpine	✗	?	✗	N/A	N/A	✔	✔	✗	?
Arch Linux (latest)	Arch	✗	?	✗	N/A	✗	✔	✔	✗	?
All other linux	Other	✗	?	?	✗	✗	?	?	✗	?

Supported functionalities across different distribution channels

On the following section we try to depict what functionalities are available, across the different distribution channels. There are various limitations and problems we try to attend as we evolve and grow. Through this report we want to provide some clarity as to what is available and in what way. Of course we strive to deliver our full solution through all channels, but that may not be feasible yet for some cases.

Legend:

• Auto-detect: Depends on the programs package dependencies. If the required dependencies are covered during compile time, capability is enabled
• YES: This flag implies that the functionality is available for that distribution channel
• NO: Not available at the moment for that distribution channel at this time, but may be a work-in-progress effort from the Netdata team.
• At Runtime: The given module or functionality is available and only requires configuration after install to enable it

Core functionality

Core

This is the base netdata capability, that includes basic monitoring, embedded web server, and so on.

make/make install	netdata-installer.sh	kickstart.sh	kickstart-static64.sh	Docker image	RPM packaging	DEB packaging
YES	YES	YES	YES	YES	YES	YES

• Flags/instructions to enable: None
• Flags to disable from source: None
• What packages required for auto-detect?: install-required-packages.sh netdata

DB Engine

This is the brand new database engine capability of netdata. It is a mandatory facility required by netdata. Given it's special needs and dependencies though, it remains an optional facility so that users can enjoy netdata even when they cannot cover the dependencies or the H/W requirements.

make/make install	netdata-installer.sh	kickstart.sh	kickstart-static64.sh	Docker image	RPM packaging	DEB packaging
Auto-detect	Auto-detect	YES	YES	YES	YES	YES

• Flags/instructions to enable: None
• Flags to disable from source: --disable-dbengine
• What packages required for auto-detect?: openssl, libuv1, lz4, Judy

Encryption Support (HTTPS)

This is Netdata's TLS capability that incorporates encryption on the web server and the APIs between parent and child nodes. Also a mandatory facility for Netdata, but remains optional for users who are limited or not interested in tight security

make/make install	netdata-installer.sh	kickstart.sh	kickstart-static64.sh	Docker image	RPM packaging	DEB packaging
Auto-detect	Auto-detect	YES	YES	YES	YES	YES

• Flags/instructions to enable: None
• Flags to disable from source: --disable-https
• What packages required for auto-detect?: openssl

Libraries/optimizations

JSON-C Support

make/make install	netdata-installer.sh	kickstart.sh	kickstart-static64.sh	Docker image	RPM packaging	DEB packaging
Auto-detect	Auto-detect	Auto-detect	Auto-detect	NO	YES	YES

• Flags/instructions to enable: None
• Flags to disable from source: --disable-jsonc
• What packages required for auto-detect?: json-c

Link time optimizations

make/make install	netdata-installer.sh	kickstart.sh	kickstart-static64.sh	Docker image	RPM packaging	DEB packaging
Auto-detect	Auto-detect	Auto-detect	Auto-detect	Auto-detect	Auto-detect	Auto-detect

• Flags/instructions to enable: None
• Flags to disable from source: --disable-lto
• What packages required for auto-detect?: No package dependency, depends on GCC version

External plugins, built with netdata build tools

FREEIPMI

make/make install	netdata-installer.sh	kickstart.sh	kickstart-static64.sh	Docker image	RPM packaging	DEB packaging
Auto-detect	Auto-detect	Auto-detect	Auto-detect	YES	YES	YES

• Flags/instructions to enable: None
• Flags to disable from source: --disable-plugin-freeipmi
• What packages required for auto-detect?: freeipmi-dev (or -devel)

NFACCT

make/make install	netdata-installer.sh	kickstart.sh	kickstart-static64.sh	Docker image	RPM packaging	DEB packaging
Auto-detect	Auto-detect	Auto-detect	Auto-detect	NO	YES	YES

• Flags/instructions to enable: None
• Flags to disable from source: --disable-plugin-nfacct
• What packages required for auto-detect?: libmnl-dev, libnetfilter_acct-dev

Xenstat

make/make install	netdata-installer.sh	kickstart.sh	kickstart-static64.sh	Docker image	RPM packaging	DEB packaging
Auto-detect	Auto-detect	Auto-detect	Auto-detect	NO	NO	NO

• Flags/instructions to enable: None
• Flags to disable from source: --disable-plugin-xenstat
• What packages required for auto-detect?: xen-dom0-libs-devel or xen-devel, yajl-dev or yajl-devel Note: for cent-OS based systems you will need centos-release-xen repository to get xen-devel

CUPS

make/make install	netdata-installer.sh	kickstart.sh	kickstart-static64.sh	Docker image	RPM packaging	DEB packaging
Auto-detect	Auto-detect	Auto-detect	Auto-detect	NO	YES	YES

• Flags/instructions to enable: None
• Flags to disable from source: --disable-plugin-cups
• What packages required for auto-detect?: cups-devel >= 1.7

FPING

make/make install	netdata-installer.sh	kickstart.sh	kickstart-static64.sh	Docker image	RPM packaging	DEB packaging
At Runtime	At Runtime	At Runtime	At Runtime	At Runtime	At Runtime	At Runtime

• Flags/instructions to enable: ${INSTALL_PATH}/netdata/plugins.d/fping.plugin install
• Flags to disable from source: None -- just dont install
• What packages required for auto-detect?: None - only fping installed to start it up

IOPING

make/make install	netdata-installer.sh	kickstart.sh	kickstart-static64.sh	Docker image	RPM packaging	DEB packaging
At Runtime	At Runtime	At Runtime	At Runtime	At Runtime	At Runtime	At Runtime

• Flags/instructions to enable: ${INSTALL_PATH}/netdata/plugins.d/ioping.plugin install
• Flags to disable from source: None -- just dont install
• What packages required for auto-detect?: None - only ioping installed to start it up

PERF

make/make install	netdata-installer.sh	kickstart.sh	kickstart-static64.sh	Docker image	RPM packaging	DEB packaging
At Runtime	At Runtime	At Runtime	At Runtime	At Runtime	At Runtime	At Runtime

• Flags/instructions to enable: Inside netdata.conf, section [Plugins], set "perf = yes"
• Flags to disable from source: --disable-perf
• What packages required for auto-detect?: None

Backends

Prometheus remote write

make/make install	netdata-installer.sh	kickstart.sh	kickstart-static64.sh	Docker image	RPM packaging	DEB packaging
Auto-detect	Auto-detect	Auto-detect	Auto-detect	NO	YES	YES

• Flags/instructions to enable: None
• Flags to disable from source: --disable-backend-prometheus-remote-write
• What packages required for auto-detect?: snappy-devel, protobuf, protobuf-compiler

AWS Kinesis

make/make install	netdata-installer.sh	kickstart.sh	kickstart-static64.sh	Docker image	RPM packaging	DEB packaging
Auto-detect	Auto-detect	Auto-detect	Auto-detect	NO	NO	NO

• Flags/instructions to enable: Instructions for AWS Kinesis
• Flags to disable from source: --disable-backend-kinesis
• What packages required for auto-detect?: AWS SDK for C++, libcurl, libssl, libcrypto