Skip to main content

Install Netdata Using Native DEB/RPM Packages

note

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.

note

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​

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

Supported Distributions​

Within each repository group, you'll find directories for specific distributions:

Repository DirectoryPrimary DistributionCompatible Distributions
amazonlinuxAmazon LinuxBinary-compatible Amazon Linux based distros
elRed Hat Enterprise LinuxCentOS, AlmaLinux, Rocky Linux, and other binary-compatible distros
fedoraFedoraBinary-compatible Fedora-based distros
olOracle LinuxBinary-compatible Oracle Linux based distros
opensuseopenSUSEBinary-compatible SUSE-based distros

Repository Structure​

Each distribution has:

  1. Directories for each supported release version
  2. 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​

  1. Download the appropriate config package for your distribution:
    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 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, install epel-release manually.

Manual Setup of DEB Packages​

You can find our DEB repositories at: https://repository.netdata.cloud/repos/index.html

Available Repository Groups​

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

Supported Distributions​

Within each repository group, you'll find directories for specific distributions:

  • debian: For Debian Linux and binary-compatible distributions
  • ubuntu: 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/).

important

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

Example Configuration​

Click to view example APT configuration

Here's an example APT sources entry for Debian 11 (Bullseye) stable releases:

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

And the equivalent Deb822 format:

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

Installation Steps​

  1. Download the appropriate config package for your distribution:
    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

Example: Complete Installation on Ubuntu 22.04 (Jammy)​

Click to view complete installation example

Here's a complete example of installing Netdata on Ubuntu 22.04 using native packages:

# Step 1: Download the repository configuration package
wget https://repository.netdata.cloud/repos/repoconfig/ubuntu/jammy/netdata-repo_latest.jammy_all.deb

# Step 2: Install the repository configuration
sudo apt install ./netdata-repo_latest.jammy_all.deb

# Step 3: Update package lists
sudo apt update

# Step 4: Install Netdata
sudo apt install netdata

# Step 5: Start and enable Netdata service
sudo systemctl enable --now netdata

# Step 6: Verify installation
curl localhost:19999/api/v1/info

After installation, you can access the Netdata dashboard at http://localhost:19999.

Local Mirrors of the Official Netdata Repositories​

You can create local mirrors of our repositories using two main approaches:

MethodUse caseExample
Standard toolsFor formal repository mirroringaptly mirror create netdata-stable http://repository.netdata.cloud/repos/stable/debian/ bullseye/
Simple mirroringFor basic HTTP mirroringwget --mirror https://repository.netdata.cloud/repos/

Mirror Root URL​

https://repository.netdata.cloud/repos/

Important Mirroring Tips​

important
  • Repository config packages: These don't support custom mirrors (except caching proxies like apt-cacher-ng). Configure mirrors manually.
  • Build process: Packages are built in stages by architecture (64-bit x86 first, then others). Full publishing takes several hours.
  • Update frequency: Metadata updates up to six times per hour, but syncing hourly is sufficient.
  • Storage requirements: A full mirror can require up to 100 GB of space. Mirror only what you need.
  • Recommended sync time: For daily syncing, 05:00–08:00 UTC is ideal, as nightly packages are typically published by then.
  • GPG verification: If using our GPG signatures, download our public key:
    https://repository.netdata.cloud/netdatabot.gpg.key

Public Mirrors of the Official Netdata Repositories​

There are currently no official public mirrors of our repositories. If you wish to provide a public mirror of our repositories, you are welcome to do so.

important

Please clearly inform your users that your mirror is not officially supported by Netdata. We recommend following industry 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.