Skip to main content

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​

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​

OptionDescription
--non-interactiveSkip prompts and assume yes.
--interactiveForce interactive prompts.
--release-channel stableInstall stable builds (instead of nightly).
--no-updatesDisable auto-updates.
--disable-telemetryDisable anonymous statistics.
--native-onlyInstall only if native packages are available.
--static-onlyInstall only if static builds are available.
--install-prefix /optChange installation directory.
--prepare-offline-install-source ./netdata-offlinePrepare offline installation source. See Offline Install Guide.

Environment Variables (Advanced Users)​

VariablePurpose
TMPDIRDirectory for temporary files.
ROOTCMDCommand used for privilege escalation (default: sudo or doas).
DISABLE_TELEMETRY=1Disables 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.