Skip to main content

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.

Our kickstart.sh installer uses these packages by default on supported platforms.

Add --native-only when running kickstart.sh to force native packages. The script will fail if native packages aren’t available.

note

Until late 2024, Netdata packages were hosted on Package Cloud. All packages are now provided exclusively from our own repositories.


Manual Setup of RPM Packages

Repositories: https://repository.netdata.cloud/repos/index.html

Available groups:

RepoPurpose
stableStable Netdata Agent releases
edgeNightly builds
repoconfigConfiguration packages
develDev builds (ignore)

Supported distributions:

  • amazonlinux
  • el (RHEL, CentOS, AlmaLinux, Rocky Linux)
  • fedora
  • ol (Oracle Linux)
  • opensuse

Example repository for RHEL 9 x86_64:
https://repository.netdata.cloud/repos/stable/el/9/x86_64/

GPG Key fingerprint:
6E155DC153906B73765A74A99DD4A74CECFA8F4F

Public key:
https://repository.netdata.cloud/netdatabot.gpg.key

Steps

  1. Download config package:
    https://repository.netdata.cloud/repos/repoconfig/index.html

  2. Install it with your package manager:

    # For RHEL/CentOS/Fedora
    sudo rpm -i netdata-repo-*.rpm
    sudo dnf install netdata

    Note
    On RHEL systems, EPEL repository is required. Our config packages handle this automatically — if not, install epel-release manually.


Manual Setup of DEB Packages

Repositories: https://repository.netdata.cloud/repos/index.html

Available groups:

RepoPurpose
stableStable Netdata Agent releases
edgeNightly builds
repoconfigConfiguration packages
develDev builds (ignore)

Supported distributions:

  • debian
  • ubuntu

APT source for Debian 11 (Bullseye):

deb by-hash=yes http://repository.netdata.cloud/repos/stable/debian/ bullseye/

Deb822 format:

Types: deb
URIs: http://repository.netdata.cloud/repos/stable/debian/
Suites: bullseye/
By-Hash: Yes
Enabled: Yes

GPG Key fingerprint:
6E155DC153906B73765A74A99DD4A74CECFA8F4F

Public key:
https://repository.netdata.cloud/netdatabot.gpg.key

Steps

  1. Download config package:
    https://repository.netdata.cloud/repos/repoconfig/index.html

  2. Install it using your package manager:

    # For Debian/Ubuntu
    sudo apt install ./netdata-repo_*.deb
    sudo apt update
    sudo apt install netdata

Local Mirrors of the Official Netdata Repositories

You can mirror Netdata’s repositories:

MethodUse case
Standard toolse.g., Aptly (APT) or reposync (RPM)
Simple mirroringUse wget --mirror or similar tools

Mirror root URL:
https://repository.netdata.cloud/repos/


Mirror Tips:

  • Config packages don’t support custom mirrors — configure mirrors manually.
  • Packages are built in stages by architecture.
  • Metadata updates up to six times/hour.
  • Full mirror can require up to 100 GB.
  • Ideal sync window: 05:00–08:00 UTC.
  • Fetch a GPG key from:
    https://repository.netdata.cloud/netdatabot.gpg.key

Public Mirrors of the Official Netdata Repositories

note

There are no official public mirrors.

If you wish to provide a public mirror of Netdata repositories:

  • You’re free to do so.
  • Please clearly state to your users that it is not an official mirror.
  • Follow best practices for repository mirroring and security.

Do you have any feedback for this page? If so, you can open a new issue on our netdata/learn repository.