Skip to main content

Install Netdata on Offline Systems

This guide explains how to install Netdata Agent on systems without internet access.

Netdata supports offline installation of the Agent using our kickstart.sh script.

This method:

  • Downloads all required files in advance.
  • Works with static builds only (for now).
  • Does not support automatic updates on offline systems.
note

Local package tools like apt-offline may work for DEB/RPM installs — but we don’t officially support them.


Step 1: Prepare the Offline Installation Package

On your internet-connected machine, you'll need::

RequirementPurpose
curl or wgetDownload the script
sha256sum or shasumVerify script downloads
POSIX-compliant shellRequired to run the script

Run the following command:

  • using wget
    wget -O /tmp/netdata-kickstart.sh https://get.netdata.cloud/kickstart.sh
    sh /tmp/netdata-kickstart.sh --release-channel stable --prepare-offline-install-source ./netdata-offline
  • or using curl
    curl https://get.netdata.cloud/kickstart.sh > /tmp/netdata-kickstart.sh
    sh /tmp/netdata-kickstart.sh --release-channel stable --prepare-offline-install-source ./netdata-offline
note

The folder name netdata-offline is just an example — use any name you want. To use the nightly channel instead, replace stable with nightly.

What's Included:

The script creates a directory with all necessary files:

── netdata-offline
├── channel # Release channel info
├── install.sh # Installation script
├── kickstart.sh # Original kickstart script
├── netdata-*.gz.run # Netdata static packages for different architectures
└── sha256sums.txt # Verification hashes

Step 2: Transfer to Offline System

Copy the entire netdata-offline directory to your offline system using your preferred method (USB drive, secure copy, etc.).

warning

Do not rename or modify any files in the package. The installation script expects the exact directory structure and filenames.

tip

The folder name netdata-offline is just an example — use any name you want.


Output

This will create a directory like:

./netdata-offline/

It will contain everything required to install Netdata offline.


Choose Release Channel (Optional)

To prepare for a specific channel (nightly or stable), add:

--release-channel nightly

or

--release-channel stable

Example:

sh /tmp/netdata-kickstart.sh --release-channel stable --prepare-offline-install-source ./netdata-offline

Install Netdata on the Target (Offline) System

  1. Copy the entire netdata-offline directory to your offline system.
warning

Don't rename or modify the files.


  1. On the offline system, run:
cd netdata-offline
sudo ./install.sh

The install.sh script accepts the same parameters as kickstart.sh, allowing you to customize your installation.

Automatic Updates

note

Automatic updates are disabled by default for offline installations — since there’s no network connection.


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