Skip to main content

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

Starting with v1.30, Netdata collects anonymous usage information by default and sends it to a self hosted PostHog instance within the Netdata infrastructure. 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 updates 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 program. (DO_NOT_TRACK=1)

Reach out

If you need help after reading this doc, search our community forum for an answer. There's a good chance someone else has already found a solution to the same issue.

Documentation

Community

Last updated on