Install Netdata on FreeBSD
💡 This guide is community-maintained and might not always reflect the latest details (like package versions).
Double-check before proceeding!
Want to help? Submit a PR!
1. Install dependencies​
Run as root
:
pkg install bash e2fsprogs-libuuid git curl autoconf automake pkgconf pidof liblz4 libuv json-c cmake gmake
Approve any prompts that appear.
2. Choose an Installation Method​
Option A: Kickstart Installer (Recommended)​
The simplest approach is to use our one-line kickstart installer.
-
Prepare the installation command:
- For Netdata Cloud users: Navigate to your Space, click Add Nodes → Copy the command from the "Linux" tab.
- For standalone installation, use the example below.
-
Run the installation command:
wget -O /tmp/netdata-kickstart.sh https://get.netdata.cloud/kickstart.sh && sh /tmp/netdata-kickstart.sh --claim-token <YOUR_TOKEN> --claim-url https://app.netdata.cloud
Replace
<YOUR_TOKEN>
with your actual claim token. -
After installation, access your Netdata dashboard at:
http://NODE:19999
(
NODE
= your FreeBSD machine's hostname or IP)
Option B: FreeBSD Ports Installation​
Netdata is also available through the FreeBSD Ports collection:
https://www.freshports.org/net-mgmt/netdata/
Option C: Manual Installation (For Advanced Users)​
-
Download the latest Netdata release:
fetch https://github.com/netdata/netdata/releases/latest/download/netdata-latest.tar.gz
Or download a specific version:
fetch https://github.com/netdata/netdata/releases/download/v2.3.2/netdata-v2.3.2.tar.gz
-
Extract the downloaded archive:
tar -xzf netdata*.tar.gz && rm netdata*.tar.gz
-
Install Netdata to
/opt/netdata
:cd netdata-v*
./netdata-installer.sh --install-prefix /opt -
Configure Netdata to start automatically at boot:
sysrc netdata_enable="YES"
-
Start the Netdata service:
service netdata start
3. Updating Netdata Installation​
If you enabled auto-updates with --auto-update
, no further action is needed.
For manual updates:
cd /opt/netdata/usr/libexec/netdata/
./netdata-updater.sh
Optional Kickstart Parameters​
Option | Description |
---|---|
--non-interactive | Skip prompts and assume yes. |
--interactive | Force interactive prompts. |
--release-channel stable | Install stable builds (instead of nightly). |
--no-updates | Disable auto-updates. |
--disable-telemetry | Disable anonymous statistics. |
--native-only | Install only if native packages are available. |
--static-only | Install only if static builds are available. |
--install-prefix /opt | Change installation directory. |
--prepare-offline-install-source ./netdata-offline | Prepare offline installation source. See Offline Install Guide. |
Environment Variables (Advanced Users)​
Variable | Purpose |
---|---|
TMPDIR | Directory for temporary files. |
ROOTCMD | Command used for privilege escalation (default: sudo or doas ). |
DISABLE_TELEMETRY=1 | Disables anonymous telemetry data. |
Telemetry Notice​
Anonymous usage data is collected by default. You can learn more or opt-out here.
Do you have any feedback for this page? If so, you can open a new issue on our netdata/learn repository.