offline.md

Install Netdata on offline systems

You can install Netdata on systems without internet access, but you need to take a few extra steps to make it work.

By default, the kickstart.sh and kickstart-static64.sh download Netdata assets, like the precompiled binary and a few dependencies, using the system's internet connection, but you can also supply these files from the local filesystem.

First, download the required files. If you're using kickstart.sh, you need the Netdata tarball, the checksums, the go.d plugin binary, and the go.d plugin configuration. If you're using kickstart-static64.sh, you need only the Netdata tarball and checksums.

Download the files you need to a system of yours that's connected to the internet. You can use the commands below, or visit the latest Netdata release page and latest go.d plugin release page to download the required files manually.

If you're using kickstart.sh, use the following commands:

cd /tmp

curl -s https://my-netdata.io/kickstart.sh > kickstart.sh

# Netdata tarball
curl -s https://api.github.com/repos/netdata/netdata/releases/latest | grep "browser_download_url.*tar.gz" | cut -d '"' -f 4 | wget -qi -

# Netdata checksums
curl -s https://api.github.com/repos/netdata/netdata/releases/latest | grep "browser_download_url.*txt" | cut -d '"' -f 4 | wget -qi -

# Netdata dependency handling script
wget -q - https://raw.githubusercontent.com/netdata/netdata/master/packaging/installer/install-required-packages.sh

# go.d plugin 
# For binaries for OS types and architectures not listed on [go.d releases](https://github.com/netdata/go.d.plugin/releases/latest), kindly open a github issue and we will do our best to serve your request
export OS=$(uname -s | tr '[:upper:]' '[:lower:]') ARCH=$(uname -m | sed -e 's/i386/386/g' -e 's/i686/386/g' -e 's/x86_64/amd64/g' -e 's/aarch64/arm64/g' -e 's/armv64/arm64/g' -e 's/armv6l/arm/g' -e 's/armv7l/arm/g' -e 's/armv5tel/arm/g') && curl -s https://api.github.com/repos/netdata/go.d.plugin/releases/latest | grep "browser_download_url.*${OS}-${ARCH}.tar.gz" | cut -d '"' -f 4 | wget -qi -

# go.d configuration 
curl -s https://api.github.com/repos/netdata/go.d.plugin/releases/latest | grep "browser_download_url.*config.tar.gz" | cut -d '"' -f 4 | wget -qi -

If you're using kickstart-static64.sh, use the following commands:

cd /tmp

curl -s https://my-netdata.io/kickstart-static64.sh > kickstart-static64.sh

# Netdata static64 tarball
curl -s https://api.github.com/repos/netdata/netdata/releases/latest | grep "browser_download_url.*gz.run" | cut -d '"' -f 4 | wget -qi -

# Netdata checksums
curl -s https://api.github.com/repos/netdata/netdata/releases/latest | grep "browser_download_url.*txt" | cut -d '"' -f 4 | wget -qi -

Move downloaded files to the /tmp directory on the offline system in whichever way your defined policy allows (if any).

Now you can run either the kickstart.sh or kickstart-static64.sh scripts using the --local-files option. This option requires you to specify the location and names of the files you just downloaded.

When using --local-files, the kickstart.sh or kickstart-static64.sh scripts won't download any Netdata assets from the internet. But, you may still need a connection to install dependencies using your system's package manager. The scripts will warn you if your system doesn't have all the dependencies.

# kickstart.sh
bash kickstart.sh --local-files /tmp/netdata-(version-number-here).tar.gz /tmp/sha256sums.txt /tmp/go.d.plugin-(version-number-here).(OS)-(architecture).tar.gz /tmp/config.tar.gz /tmp/install-required-packages.sh

# kickstart-static64.sh
bash kickstart-static64.sh --local-files /tmp/netdata-(version-number-here).gz.run /tmp/sha256sums.txt

Now that Netdata is installed, be sure to visit our getting started guide for a quick overview of configuring Netdata, enabling plugins, and controlling Netdata's daemon.

Or, get the full guided tour of Netdata's capabilities with our step-by-step guide!