Skip to main content

Update Netdata

tip

What You'll Learn

How to update Netdata based on your installation method, determine your installation type, and configure the updater behavior.

The update process can differ based on the installation type:

Determine which installation method you used

important

First Step

Before updating, you need to identify your installation type to choose the correct update method.

You can run the following to determine your installation type:

netdata -W buildinfo | grep -E 'Installation Type|Install type:'
tip

If the above command doesn't work

If you're using an older Netdata version or the above command doesn't output anything, try our one-line installation script in dry-run mode. Run the following command to determine the appropriate update method:

wget -O /tmp/netdata-kickstart.sh https://get.netdata.cloud/kickstart.sh && sh /tmp/netdata-kickstart.sh --dry-run
note

Installation Prefix

If you installed Netdata using an installation prefix, you will need to add an --install-prefix option specifying that prefix to make sure it finds the existing installation.

If you see a line starting with --- Would attempt to update existing installation by running the updater script located at:, then our kickstart script update method will work for you.

Otherwise, it should either indicate that the installation type is not supported (which probably means you either have a custom install or built Netdata manually) or indicate that it would create a new install (which means that you either used a non-standard installation path, or that you don't have Netdata installed).

:::

The following table contains all possible installation types:

Installation-typeDescription
binpkg-rpmRPM-based native packages shipped from Netdata's repos.
binpkg-debDEB-based native packages shipped from Netdata's repos.
kickstart-buildBuild from source with the kickstart script's --build-only option.
kickstart-staticInstalled the static builds, shipped from netdata via the kickstart script's (option: --static-only).
manual-static-ARCHManually installed static Agent binaries by downloading archives from GitHub and installing them manually. Offline installations are part of this category.
legacy-buildUsed for pre-existing kickstart.sh or netdata-installer.sh installations. This exist because we cannot determine how the install originally happened.
legacy-staticSame as legacy-build, but for static installs.
ociInstalled using official Docker images from Netdata, though not necessarily running on Docker
customAnything not covered by the other identifiers, including manual builds, manually running netdata-installer.sh, and third-party packages (community).
UnknownSame as custom.

Update Methods by Platform

UNIX

In most cases, you can update Netdata using our one-line kickstart script. This script will automatically run the update script installed as part of the initial install and preserve the existing installation options you specified.

If you installed Netdata using an installation prefix, you will need to add an --install-prefix option specifying that prefix to this command to make sure it finds Netdata.

wget -O /tmp/netdata-kickstart.sh https://get.netdata.cloud/kickstart.sh && sh /tmp/netdata-kickstart.sh

Windows

To update Netdata, download the latest installer and reinstall the Agent.

For automatic updates, see our Windows automatic updates guide.


macOS

If you installed Netdata on your macOS system using Homebrew, you can explicitly request an update:

brew upgrade netdata

Homebrew downloads the latest Netdata via the formula, ensures all dependencies are met, and updates Netdata via reinstallation.


Manual installation from Git

If you installed Netdata manually from Git run our automatic requirements installer, which works on many Linux distributions, to ensure your system has the dependencies necessary for new features.

bash <(curl -sSL https://raw.githubusercontent.com/netdata/netdata/master/packaging/installer/install-required-packages.sh)

Navigate to the directory where you first cloned the Netdata repository, pull the latest source code, and run netdata-install.sh again. This process compiles Netdata with the latest source code and updates it via reinstallation.

cd /path/to/netdata/git
git pull origin master
sudo ./netdata-installer.sh
note

Optional Parameters

If you installed Netdata with any optional parameters, such as --install-prefix to install under a specific directory, you need to set them again during this process.


Additional Configuration

Control runtime behavior of the updater script

Starting with v1.40.0, the netdata-updater.sh script supports a config file called netdata-updater.conf, located in the same directory as the main netdata.conf file. This file uses POSIX shell script syntax to define variables that are used by the updater.

This configuration file can be edited using our edit-config script.

Available Configuration Options:

OptionDescriptionDefault
NETDATA_UPDATER_JITTERSets an upper limit in seconds on the random delay in the updater script when running as a scheduled task. This random delay helps avoid issues resulting from too many nodes trying to reconnect to the Cloud at the same time. Most users shouldn't ever need to change this.3600 (one hour)
NETDATA_MAJOR_VERSION_UPDATESIf set to a value other than 0, then new major versions will be installed without user confirmation. Must be set to a non-zero value for automated updates to install new major versions.0
NETDATA_NO_SYSTEMD_JOURNALIf set to a value other than 0, skip attempting to install the netdata-plugin-systemd-journal package on supported systems on update. The updater will install this optional package by default on supported systems if this option is not set. It only affects systems using native packages.0

Quick Reference

Update Commands by Installation Type

Installation TypeUpdate MethodCommand
binpkg-rpm/debKickstart scriptwget -O /tmp/netdata-kickstart.sh https://get.netdata.cloud/kickstart.sh && sh /tmp/netdata-kickstart.sh
kickstart-build/staticKickstart scriptwget -O /tmp/netdata-kickstart.sh https://get.netdata.cloud/kickstart.sh && sh /tmp/netdata-kickstart.sh
legacy-build/staticKickstart scriptwget -O /tmp/netdata-kickstart.sh https://get.netdata.cloud/kickstart.sh && sh /tmp/netdata-kickstart.sh
manual-static-ARCHKickstart scriptwget -O /tmp/netdata-kickstart.sh https://get.netdata.cloud/kickstart.sh && sh /tmp/netdata-kickstart.sh
customSystem package managerUse your system's package manager
macOS (Homebrew)Homebrewbrew upgrade netdata
Manual GitGit + installerSee manual installation steps
WindowsMSI installerDownload and run latest installer

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