Install Netdata Using Native DEB/RPM Packages
Netdata provides pre-built native packages for most DEB- and RPM-based Linux distributions, following our platform support policy.
Install Netdata using our kickstart.sh installer, which automatically uses native packages on supported platforms.
To ensure the installer only uses native packages, add the --native-only
option when running kickstart.sh
.
Our previous PackageCloud repositories are no longer updated. All packages are now available exclusively from our own repositories.
Repository Structure Overview
Our repository system follows a structured organization:
repository.netdata.cloud/repos/
├── stable/ # Stable Netdata Agent releases
│ ├── debian/ # For Debian-based distributions
│ │ ├── bullseye/ # Distribution codename directories
│ │ ├── bookworm/
│ │ └── ...
│ ├── ubuntu/ # For Ubuntu-based distributions
│ │ ├── focal/
│ │ ├── jammy/
│ │ └── ...
│ ├── el/ # For RHEL-based distributions
│ │ ├── 8/ # Version directories
│ │ │ ├── x86_64/ # Architecture directories
│ │ │ ├── aarch64/
│ │ │ └── ...
│ │ ├── 9/
│ │ └── ...
│ └── other distros...
├── edge/ # Nightly builds (same structure)
├── repoconfig/ # Configuration packages
└── devel/ # Development builds (ignore)
Manual Setup of RPM Packages
You can find our RPM repositories at: https://repository.netdata.cloud/repos/index.html
Available Repository Groups
Repo | Purpose |
---|---|
stable | Stable Netdata Agent releases |
edge | Nightly builds |
repoconfig | Configuration packages |
devel | Dev builds (ignore) |
Supported Distributions
Within each repository group, you'll find directories for specific distributions:
Repository Directory | Primary Distribution | Compatible Distributions |
---|---|---|
amazonlinux | Amazon Linux | Binary-compatible Amazon Linux based distros |
el | Red Hat Enterprise Linux | CentOS, AlmaLinux, Rocky Linux, and other binary-compatible distros |
fedora | Fedora | Binary-compatible Fedora-based distros |
ol | Oracle Linux | Binary-compatible Oracle Linux based distros |
opensuse | openSUSE | Binary-compatible SUSE-based distros |
Repository Structure
Each distribution has:
- Directories for each supported release version
- Subdirectories for each supported CPU architecture containing the actual packages
Example: For RHEL 9 on 64-bit x86, you'll find the stable repository at:
https://repository.netdata.cloud/repos/stable/el/9/x86_64/
Package Signing
Our RPM packages and repository metadata are signed with a GPG key with a username of Netdatabot
and the fingerprint:
6E155DC153906B73765A74A99DD4A74CECFA8F4F
Download the public key from:
https://repository.netdata.cloud/netdatabot.gpg.key
Installation Steps
-
Download the appropriate config package for your distribution:
https://repository.netdata.cloud/repos/repoconfig/index.html -
Install it with your package manager:
# For RHEL/CentOS/Fedora
sudo rpm -i netdata-repo-*.rpm
sudo dnf install netdatanoteOn RHEL and other
el
repository distributions, some Netdata dependencies are in the EPEL repository. Our config packages typically handle this automatically, but if you encounter issues, installepel-release
manually.
Manual Setup of DEB Packages
You can find our DEB repositories at: https://repository.netdata.cloud/repos/index.html
Available Repository Groups
Repo | Purpose |
---|---|
stable | Stable Netdata Agent releases |
edge | Nightly builds |
repoconfig | Configuration packages |
devel | Dev builds (ignore) |
Supported Distributions
Within each repository group, you'll find directories for specific distributions:
debian
: For Debian Linux and binary-compatible distributionsubuntu
: For Ubuntu Linux and binary-compatible distributions
Repository Structure
Our DEB repositories use a flat repository structure (per Debian standards) and support by-hash metadata retrieval for improved reliability.
Each directory contains subdirectories for supported releases, named by codename (e.g., bullseye/
, jammy/
).
When configuring repository URLs, include the trailing slash (/
) after the codename. This is required for the repository to be processed correctly.
Package Signing
Our DEB packages and repository metadata are signed with a GPG key with a username of Netdatabot
and the fingerprint:
6E155DC153906B73765A74A99DD4A74CECFA8F4F
Download the public key from:
https://repository.netdata.cloud/netdatabot.gpg.key