Skip to main content

Install Netdata on offline systems

Our kickstart install script provides support for installing the Netdata Agent on air-gapped systems which do not have a usable internet connection by prefetching all of the required files so that they can be copied to the target system. Currently, we only support using static installs with this method. There are tentative plans to support building locally on offline systems as well, but there is currently no estimate of when this functionality may be implemented.

Users who wish to use native packages on offline systems may be able to do so using whatever tooling their distribution already provides for offline package management (such as apt-offline on Debian or Ubuntu systems), but this is not officially supported.

Preparing the offline installation source

The first step to installing Netdata on an offline system is to prepare the offline installation source. This can be as a regular user from any internet connected system that has the following tools available:

  • cURL or wget
  • sha256sum or shasum
  • A standard POSIX compliant shell

To prepare the offline installation source, simply run:

wget -O /tmp/netdata-kickstart.sh https://get.netdata.cloud/kickstart.sh && sh /tmp/netdata-kickstart.sh --prepare-offline-install-source ./netdata-offline

or

curl https://get.netdata.cloud/kickstart.sh > /tmp/netdata-kickstart.sh && sh /tmp/netdata-kickstart.sh --prepare-offline-install-source ./netdata-offline

The exact name used for the directory does not matter, you can specify any other name you want in place of ./netdata-offline.

This will create a directory called netdata-offline in the current directory and place all the files required for an offline install in it.

If you want to use a specific release channel (nightly or stable), it must be specified on this step using the appropriate option for the kickstart script.

Installing on the target system

Once you have prepared the offline install source, you need to copy the offline install source directory to the target system. This can be done in any manner you like, as long as filenames are not changed.

After copying the files, simply run the install.sh script located in the offline install source directory. It accepts all the same options as the kickstart script for further customization of the installation, though it will default to not enabling automatic updates (as they are not supported on offline installs).


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