Install Netdata on FreeBSD

💡 This document is maintained by Netdata's community, and may not be completely up-to-date. Please double-check the details of the installation process, such as version numbers for downloadable packages, before proceeding.

You can help improve this document by submitting a PR with your recommended improvements or changes. Thank you!

Install latest version#

This is how to install the latest Netdata version on FreeBSD:

Install required packages (need root permission):

pkg install bash e2fsprogs-libuuid git curl autoconf automake pkgconf pidof Judy liblz4 libuv json-c cmake gmake

Download Netdata:

fetch https://github.com/netdata/netdata/releases/download/v1.26.0/netdata-v1.26.0.tar.gz

⚠️ Verify the latest version by either navigating to Netdata's latest release or using curl:

basename $(curl -Ls -o /dev/null -w %{url_effective} https://github.com/netdata/netdata/releases/latest)

Unzip the downloaded file:

gunzip netdata*.tar.gz && tar xf netdata*.tar && rm -rf netdata*.tar

Install Netdata in /opt/netdata. If you want to enable automatic updates, add --auto-update or -u to install netdata-updater in cron (need root permission):

cd netdata-v* && ./netdata-installer.sh --install /opt && cp /opt/netdata/usr/sbin/netdata-claim.sh /usr/sbin/

You also need to enable the netdata service in /etc/rc.conf:

sysrc netdata_enable="YES"

Finally, and very importantly, update Netdata using the script provided by the Netdata team (need root permission):

cd /opt/netdata/usr/libexec/netdata/ && ./netdata-updater.sh

You can now access the Netdata dashboard by navigating to http://NODE:19999, replacing NODE with the IP address or hostname of your system.

image

From Netdata v1.12 and above, anonymous usage information is collected by default and sent to Google Analytics. To read more about the information collected and how to opt-out, check the anonymous statistics page.

Updating the Agent on FreeBSD#

If you have not passed the --auto-update or -u parameter for the installer to enable automatic updating, repeat the last step to update Netdata whenever a new version becomes available. The netdata-updater.sh script will update your Agent.

Optional parameters to alter your installation#

parametersDescription
--install <path>Install netdata in <path>. Ex: --install /opt will put netdata in /opt/netdata
--dont-start-itDo not (re)start netdata after installation
--dont-waitRun installation in non-interactive mode
--auto-update or -uInstall netdata-updater in cron to update netdata automatically once per day
--stable-channelUse packages from GitHub release pages instead of GCS (nightly updates). This results in less frequent updates
--nightly-channelUse most recent nightly udpates instead of GitHub releases. This results in more frequent updates
--disable-goDisable installation of go.d.plugin
--disable-ebpfDisable eBPF Kernel plugin (Default: enabled)
--disable-cloudDisable all Netdata Cloud functionality
--require-cloudFail the install if it can't build Netdata Cloud support
--enable-plugin-freeipmiEnable the FreeIPMI plugin. Default: enable it when libipmimonitoring is available
--disable-plugin-freeipmiEnable the FreeIPMI plugin
--disable-httpsExplicitly disable TLS support
--disable-dbengineExplicitly disable DB engine support
--enable-plugin-nfacctEnable nfacct plugin. Default: enable it when libmnl and libnetfilter_acct are available
--disable-plugin-nfacctDisable nfacct plugin. Default: enable it when libmnl and libnetfilter_acct are available
--enable-plugin-xenstatEnable the xenstat plugin. Default: enable it when libxenstat and libyajl are available
--disable-plugin-xenstatDisable the xenstat plugin
--enable-backend-kinesisEnable AWS Kinesis backend. Default: enable it when libaws_cpp_sdk_kinesis and libraries (it depends on are available)
--disable-backend-kinesisDisable AWS Kinesis backend. Default: enable it when libaws_cpp_sdk_kinesis and libraries (it depends on are available)
--enable-backend-prometheus-remote-writeEnable Prometheus remote write backend. Default: enable it when libprotobuf and libsnappy are available
--disable-backend-prometheus-remote-writeDisable Prometheus remote write backend. Default: enable it when libprotobuf and libsnappy are available
--enable-backend-mongodbEnable MongoDB backend. Default: enable it when libmongoc is available
--disable-backend-mongodbDisable MongoDB backend
--enable-ltoEnable Link-Time-Optimization. Default: enabled
--disable-ltoDisable Link-Time-Optimization. Default: enabled
--disable-x86-sseDisable SSE instructions. By default SSE optimizations are enabled
--zlib-is-really-here or --libs-are-really-hereIf you get errors about missing zlib or libuuid but you know it is available, you might have a broken pkg-config. Use this option to proceed without checking pkg-config
--disable-telemetryUse this flag to opt-out from our anonymous telemetry progam. (DO_NOT_TRACK=1)
Last updated on