Install Netdata with kickstart.sh¶
This page covers detailed instructions on using and configuring the automatic one-line installation script named
This method is fully automatic on all Linux distributions. To install Netdata from source and get automatic nightly updates, run the following as your normal user:
bash <(curl -Ss https://my-netdata.io/kickstart.sh)
kickstart.sh script does the following after being downloaded and run using
- Detects the Linux distribution and installs the required system packages for building Netdata. Unless you added
--dont-waitoption, it will ask for your permission first.
- Downloads the latest Netdata source tree to
- Installs Netdata by running
./netdata-installer.shfrom the source tree, using any optional parameters you have specified.
cron.daily, so your Netdata installation will be updated with new nightly versions, unless you override that with an optional parameter.
- Prints a message whether installation succeeded or failed for QA purposes.
Optional parameters to alter your installation¶
kickstart.sh script passes all its parameters to
netdata-installer.sh, which you can use to customize your
installation. Here are a few important parameters:
--dont-wait: Enable automated installs by not prompting for permission to install any required packages.
--dont-start-it: Prevent the installer from starting Netdata automatically.
--stable-channel: Automatically update only on the release of new major versions.
--nightly-channel: Automatically update on every new nightly build.
--disable-telemetry: Opt-out of anonymous statistics we use to make Netdata better.
--no-updates: Prevent automatic updates of any kind.
--local-files: Used for offline installations. Pass four file paths: the Netdata tarball, the checksum file, the go.d plugin tarball, and the go.d plugin config tarball, to force kickstart run the process using those files. This option conflicts with the
--stable-channeloption. If you set this and
--stable-channel, Netdata will use the local files.
Verify script integrity¶
md5sum to verify the intregity of the
kickstart.sh script you will download using the one-line command above,
run the following:
[ "952da7868b2c6b8819a7c600047400f5" = "$(curl -Ss https://my-netdata.io/kickstart.sh | md5sum | cut -d ' ' -f 1)" ] && echo "OK, VALID" || echo "FAILED, INVALID"
If the script is valid, this command will return
When you finish installing Netdata, be sure to visit our step-by-step tutorial for a fully-guided tour into Netdata’s capabilities and how to configure it according to your needs.
Or, if you’re a monitoring and system administration pro, skip ahead to our getting started guide for a quick overview.