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.
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::
Requirement | Purpose |
---|---|
curl or wget | Download the script |
sha256sum or shasum | Verify script downloads |
POSIX-compliant shell | Required 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
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.).
Do not rename or modify any files in the package. The installation script expects the exact directory structure and filenames.
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
- Copy the entire
netdata-offline
directory to your offline system.
Don't rename or modify the files.
- 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
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.