💡 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!
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 gmakeDownload 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 usingcurl: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*.tarInstall 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.shYou can now access the Netdata dashboard by navigating to http://NODE:19999, replacing NODE with the IP address or hostname of your system.
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.
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.
| parameters | Description |
|---|---|
--install <path> |
Install netdata in <path>. Ex: --install /opt will put netdata in /opt/netdata |
--dont-start-it |
Do not (re)start netdata after installation |
--dont-wait |
Run installation in non-interactive mode |
--auto-update or -u |
Install netdata-updater in cron to update netdata automatically once per day |
--stable-channel |
Use packages from GitHub release pages instead of GCS (nightly updates). This results in less frequent updates |
--nightly-channel |
Use most recent nightly udpates instead of GitHub releases. This results in more frequent updates |
--disable-go |
Disable installation of go.d.plugin |
--disable-ebpf |
Disable eBPF Kernel plugin (Default: enabled) |
--disable-cloud |
Disable all Netdata Cloud functionality |
--require-cloud |
Fail the install if it can't build Netdata Cloud support |
--enable-plugin-freeipmi |
Enable the FreeIPMI plugin. Default: enable it when libipmimonitoring is available |
--disable-plugin-freeipmi |
Enable the FreeIPMI plugin |
--disable-https |
Explicitly disable TLS support |
--disable-dbengine |
Explicitly disable DB engine support |
--enable-plugin-nfacct |
Enable nfacct plugin. Default: enable it when libmnl and libnetfilter_acct are available |
--disable-plugin-nfacct |
Disable nfacct plugin. Default: enable it when libmnl and libnetfilter_acct are available |
--enable-plugin-xenstat |
Enable the xenstat plugin. Default: enable it when libxenstat and libyajl are available |
--disable-plugin-xenstat |
Disable the xenstat plugin |
--enable-backend-kinesis |
Enable AWS Kinesis backend. Default: enable it when libaws_cpp_sdk_kinesis and libraries (it depends on are available) |
--disable-backend-kinesis |
Disable AWS Kinesis backend. Default: enable it when libaws_cpp_sdk_kinesis and libraries (it depends on are available) |
--enable-backend-prometheus-remote-write |
Enable Prometheus remote write backend. Default: enable it when libprotobuf and libsnappy are available |
--disable-backend-prometheus-remote-write |
Disable Prometheus remote write backend. Default: enable it when libprotobuf and libsnappy are available |
--enable-backend-mongodb |
Enable MongoDB backend. Default: enable it when libmongoc is available |
--disable-backend-mongodb |
Disable MongoDB backend |
--enable-lto |
Enable Link-Time-Optimization. Default: enabled |
--disable-lto |
Disable Link-Time-Optimization. Default: enabled |
--disable-x86-sse |
Disable SSE instructions. By default SSE optimizations are enabled |
--zlib-is-really-here or --libs-are-really-here |
If 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-telemetry |
Use this flag to opt-out from our anonymous telemetry progam. (DO_NOT_TRACK=1) |