@cryptotaxi247 / netdata / commits / 3e952936b

Fixing Supported Linux Platforms and Versions (#20893)

Co-authored-by: Austin S. Hemmelgarn <ahferroin7@gmail.com>

Reuben Hu committed Aug 28, 2025 at 11:28 UTC 3e952936b1f0b56142b7b9e61f280e1454b0cc8a
1 file changed +32 -31
docs/netdata-agent/versions-and-platforms.md
+32 -31
@@ -4,12 +4,12 @@ Netdata is evolving rapidly and new features are added at a constant pace. There
4
5 You can choose from 2 Netdata Agent release channels:
6
7 -| Release Channel | Release Frequency | Support Policy & Features | Support Duration | Backwards Compatibility |
8 -|:---------------:|:---------------------------------------------:|:---------------------------------------------------------:|:----------------------------------------:|:---------------------------------------------------------------------------------:|
7 +| Release Channel | Release Frequency | Support Policy & Features | Support Duration | Backwards Compatibility |
8 +| :-------------: | :---------------------------------------------------------------------: | :-------------------------------------------------------: | :--------------------------------------: | :-------------------------------------------------------------------------------: |
9 | **Stable** | Usually 4-6 major/minor releases per year plus patch releases as needed | Receiving bug fixes and security updates between releases | Up to the 2nd stable release after them | Previous configuration semantics and data are supported by newer releases |
10 -| **Nightly** | Most nights around 02:00 UTC | Latest pre-released features | Up to the 2nd nightly release after them |Configuration and data of unreleased features may change between nightly releases|
10 +| **Nightly** | Most nights around 02:00 UTC | Latest pre-released features | Up to the 2nd nightly release after them | Configuration and data of unreleased features may change between nightly releases |
11
12 -:::info
12 +:::info
13
14 "Support Duration" defines how long we consider each release actively used in production systems. After this period, you should update to the latest release to continue receiving bug fixes and security updates.
15
@@ -25,22 +25,23 @@ You can choose from 2 Netdata Agent release channels:
25
26 We provide binary distribution packages via CI integration for the following platforms and architectures:
27
28 -| Platform | Platform Versions | Released Packages Architecture | Format |
29 -|:-----------------------:|:--------------------------------:|:------------------------------------------------:|:------------:|
30 -| **Docker under Linux** | 19.03 and later | `x86_64`, `i386`, `ARMv7`, `AArch64` | docker image |
31 -| **Static Builds** | - | `x86_64`, `ARMv6`, `ARMv7`, `AArch64` | .gz.run |
32 -| **Alma Linux** | 8.x, 9.x | `x86_64`, `AArch64` | RPM |
33 -| **Amazon Linux** | 2, 2023 | `x86_64`, `AArch64` | RPM |
34 -| **Centos** | 7.x | `x86_64` | RPM |
35 -| **Debian** | 10.x, 11.x, 12.x | `x86_64`, `i386`, `ARMv7`, `AArch64` | DEB |
36 -| **Fedora** | 37, 38, 39 | `x86_64`, `AArch64` | RPM |
37 -| **OpenSUSE** | Leap 15.4, Leap 15.5, Tumbleweed | `x86_64`, `AArch64` | RPM |
38 -| **Oracle Linux** | 8.x, 9.x | `x86_64`, `AArch64` | RPM |
39 -| **Redhat Enterprise Linux** | 7.x | `x86_64` | RPM |
40 -| **Redhat Enterprise Linux** | 8.x, 9.x | `x86_64`, `AArch64` | RPM |
41 -| **Ubuntu** | 20.04, 22.04, 23.10 | `x86_64`, `i386`, `ARMv7`, `AArch64` | DEB |
42 -
43 -:::important
28 +| Platform | Platform Versions | Released Packages Architecture | Format |
29 +| :-------------------------: | :------------------------: | :-----------------------------------: | :----------: |
30 +| **Docker under Linux** | 19.03 and later | `x86_64`, `i386`, `ARMv7`, `AArch64` | docker image |
31 +| **Static Builds** | - | `x86_64`, `ARMv6`, `ARMv7`, `AArch64` | .gz.run |
32 +| **Alma Linux** | 8.x, 9.x, 10.x | `x86_64`, `AArch64` | RPM |
33 +| **Amazon Linux** | 2, 2023 | `x86_64`, `AArch64` | RPM |
34 +| **Centos** | 7.x | `x86_64` | RPM |
35 +| **Debian** | 11.x, 12.x | `x86_64`, `i386`, `ARMv7`, `AArch64` | DEB |
36 +| **Debian** | 13.x | `x86_64`, `ARMv7`, `AArch64` | DEB |
37 +| **Fedora** | 41, 42 | `x86_64`, `AArch64` | RPM |
38 +| **OpenSUSE** | Leap 15.6, Tumbleweed | `x86_64`, `AArch64` | RPM |
39 +| **Oracle Linux** | 8.x, 9.x, 10.x | `x86_64`, `AArch64` | RPM |
40 +| **Redhat Enterprise Linux** | 7.x | `x86_64` | RPM |
41 +| **Redhat Enterprise Linux** | 8.x, 9.x, 10.x | `x86_64`, `AArch64` | RPM |
42 +| **Ubuntu** | 20.04, 22.04, 24.04, 25.04 | `x86_64`, `ARMv7`, `AArch64` | DEB |
43 +
44 +:::important
45
46 Linux distributions frequently provide binary packages of Netdata. However, **the packages you will find in the distributions' repositories may be outdated, incomplete, missing significant features or completely broken**. We recommend using the packages we provide.
47
@@ -50,8 +51,8 @@ Linux distributions frequently provide binary packages of Netdata. However, **th
51
52 The following distributions always provide the latest stable version of Netdata:
53
53 -| Platform | Platform Versions | Released Packages Architecture |
54 -|:----------:|:-----------------:|:------------------------------------:|
54 +| Platform | Platform Versions | Released Packages Architecture |
55 +| :------------: | :---------------: | :----------------------------------: |
56 | **Arch Linux** | Latest | All the Arch supported architectures |
57
58 ## Builds from Source
@@ -60,13 +61,13 @@ We guarantee that you can build Netdata from source for the platforms where we p
61
62 The following builds from source should usually work for you, although we don't regularly monitor if there are issues:
63
63 -| Platform | Platform Versions |
64 -|:-----------------------------------:|:--------------------------:|
65 -| **Linux Distributions** | Latest unreleased versions |
66 -| **FreeBSD and derivatives** | 14-STABLE |
67 -| **Gentoo and derivatives** | Latest |
68 -| **Arch Linux and derivatives** | latest from AUR |
69 -| **MacOS** | 13, 14, 15 |
64 +| Platform | Platform Versions |
65 +| :----------------------------: | :------------------------: |
66 +| **Linux Distributions** | Latest unreleased versions |
67 +| **FreeBSD and derivatives** | 14-STABLE |
68 +| **Gentoo and derivatives** | Latest |
69 +| **Arch Linux and derivatives** | latest from AUR |
70 +| **MacOS** | 13, 14, 15 |
71
72 ## Static Builds and Unsupported Linux Versions
73
@@ -85,10 +86,10 @@ When a platform is removed from the Binary Distribution Packages list:
86
87 - **No automatic transitions occur**: Your existing native package installations will remain as they are
88 - **Your local updater will report the Agent as up-to-date** even when newer versions exist.
88 -- **When a new Netdata version is published, you'll see** "*Nodes are below the recommended Agent version*" **warnings** in the Netdata Cloud UI.
89 +- **When a new Netdata version is published, you'll see** "_Nodes are below the recommended Agent version_" **warnings** in the Netdata Cloud UI.
90 - **You will stop receiving new features, improvements, and security updates**.
91
91 -:::important
92 +:::important
93
94 **We strongly recommend upgrading your operating system before it reaches EOL** to maintain full Netdata functionality and continued updates.
95