7
8
# Install Netdata on FreeBSD
9
10
-## Install from ports/packages
11
-You can install Netdata from either the `ports` or `packages` collections. To install from packages:
10
+## Install latest version
11
+This is how to install the latest Netdata version on FreeBSD:
12
+
13
+Install required packages (**need root permission**):
14
+
15
```sh
13
-# pkg install netdata
16
+pkg install bash e2fsprogs-libuuid git curl autoconf automake pkgconf pidof Judy liblz4 libuv json-c cmake
17
```
15
-You also need to enable the netdata service in `/etc/rc.conf` (add `netdata_enable="YES"`) and start the service:
18
+
19
+Download Netdata:
20
+
21
```sh
17
-# service netdata start
22
+fetch https://github.com/netdata/netdata/releases/download/v1.22.1/netdata-v1.22.1.tar.gz
23
```
24
20
-## Install latest version
21
-This is how to install the latest Netdata version from source on FreeBSD:
25
+Unzip the downloaded file:
26
27
```sh
24
-# install required packages
25
-pkg install bash e2fsprogs-libuuid git curl autoconf automake pkgconf pidof Judy liblz4 libuv json-c cmake
28
+gunzip netdata*.tar.gz && tar xf netdata*.tar && rm -rf netdata*.tar
29
+```
30
27
-# download Netdata
28
-git clone https://github.com/netdata/netdata.git --depth=100
31
+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**):
32
30
-# install Netdata in /opt/netdata
31
-cd netdata
32
-./netdata-installer.sh --install /opt
33
+```sh
34
+cd netdata-v* && ./netdata-installer.sh --install /opt && cp /opt/netdata/usr/sbin/netdata-claim.sh /usr/sbin/
35
```
36
+
37
+You also need to enable the `netdata` service in `/etc/rc.conf`:
38
+
39
+```sh
40
+sysrc netdata_enable="YES"
41
+```
42
+
43
+Finally, and very importantly, update Netdata using the script provided by the Netdata team (**need root permission**):
44
+
45
+```sh
46
+cd /opt/netdata/usr/libexec/netdata/ && ./netdata-updater.sh
47
+```
48
+
49
+You can now access the Netdata dashboard by navigating to `http://NODE:19999`, replacing `NODE` with the IP address or hostname of your system.
50
+
51
+
52
+
53
+From Netdata v1.12 and above, anonymous usage information is collected by default and sent to Google Analytics. To read
54
+more about the information collected and how to opt-out, check the [anonymous statistics
55
+page](/docs/anonymous-statistics.md).
56
+
57
+## Updating the Agent on FreeBSD
58
+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.
59
+The `netdata-updater.sh` script will update your Agent.
60
+
61
+## Optional parameters to alter your installation
62
+| parameters | Description |
63
+|:-----:|-----------|
64
+|`--install <path>`| Install netdata in `<path>.` Ex: `--install /opt` will put netdata in `/opt/netdata`|
65
+| `--dont-start-it` | Do not (re)start netdata after installation|
66
+| `--dont-wait` | Run installation in non-interactive mode|
67
+| `--auto-update` or `-u` | Install netdata-updater in cron to update netdata automatically once per day|
68
+| `--stable-channel` | Use packages from GitHub release pages instead of GCS (nightly updates). This results in less frequent updates|
69
+| `--nightly-channel` | Use most recent nightly udpates instead of GitHub releases. This results in more frequent updates|
70
+| `--disable-go` | Disable installation of go.d.plugin|
71
+| `--disable-ebpf` | Disable eBPF Kernel plugin (Default: enabled)|
72
+| `--disable-cloud` | Disable all Netdata Cloud functionality|
73
+| `--require-cloud` | Fail the install if it can't build Netdata Cloud support|
74
+| `--enable-plugin-freeipmi` | Enable the FreeIPMI plugin. Default: enable it when libipmimonitoring is available|
75
+| `--disable-plugin-freeipmi` | Enable the FreeIPMI plugin|
76
+| `--disable-https` | Explicitly disable TLS support|
77
+| `--disable-dbengine` | Explicitly disable DB engine support|
78
+| `--enable-plugin-nfacct` | Enable nfacct plugin. Default: enable it when libmnl and libnetfilter_acct are available|
79
+| `--disable-plugin-nfacct` | Disable nfacct plugin. Default: enable it when libmnl and libnetfilter_acct are available|
80
+| `--enable-plugin-xenstat` | Enable the xenstat plugin. Default: enable it when libxenstat and libyajl are available|
81
+| `--disable-plugin-xenstat` | Disable the xenstat plugin|
82
+| `--enable-backend-kinesis` | Enable AWS Kinesis backend. Default: enable it when libaws_cpp_sdk_kinesis and libraries (it depends on are available)|
83
+| `--disable-backend-kinesis` | Disable AWS Kinesis backend. Default: enable it when libaws_cpp_sdk_kinesis and libraries (it depends on are available)|
84
+| `--enable-backend-prometheus-remote-write` | Enable Prometheus remote write backend. Default: enable it when libprotobuf and libsnappy are available|
85
+| `--disable-backend-prometheus-remote-write` | Disable Prometheus remote write backend. Default: enable it when libprotobuf and libsnappy are available|
86
+| `--enable-backend-mongodb` | Enable MongoDB backend. Default: enable it when libmongoc is available|
87
+| `--disable-backend-mongodb` | Disable MongoDB backend|
88
+| `--enable-lto` | Enable Link-Time-Optimization. Default: enabled|
89
+| `--disable-lto` | Disable Link-Time-Optimization. Default: enabled|
90
+| `--disable-x86-sse` | Disable SSE instructions. By default SSE optimizations are enabled|
91
+| `--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|
92
+|`--disable-telemetry` | Use this flag to opt-out from our anonymous telemetry progam. (DO_NOT_TRACK=1)|