| 1 | # Install Netdata on pfSense CE |
| 2 | |
| 3 | :::info |
| 4 | |
| 5 | 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. |
| 6 | |
| 7 | You can help improve this document by [submitting a PR](https://github.com/netdata/netdata/edit/master/packaging/installer/methods/pfsense.md) with your recommended improvements or changes. Thank you! |
| 8 | |
| 9 | ::: |
| 10 | |
| 11 | ## Install prerequisites/dependencies |
| 12 | |
| 13 | To install Netdata on pfSense, first enable the [FreeBSD package repo](https://docs.netgate.com/pfsense/en/latest/recipes/freebsd-pkg-repo.html) |
| 14 | Then run the following command (within a shell or under the **Diagnostics/Command** |
| 15 | prompt within the pfSense web interface). |
| 16 | |
| 17 | ```bash |
| 18 | pkg install -y pkgconf bash e2fsprogs-libuuid libuv nano |
| 19 | ``` |
| 20 | |
| 21 | Then run the following commands to download various dependencies from the FreeBSD repository. |
| 22 | |
| 23 | ```sh |
| 24 | pkg install json-c-0.15_1 |
| 25 | pkg install py39-certifi-2023.5.7 |
| 26 | pkg install py39-asn1crypto |
| 27 | pkg install py39-pycparser |
| 28 | pkg install py39-cffi |
| 29 | pkg install py39-six |
| 30 | pkg install py39-cryptography |
| 31 | pkg install py39-idna |
| 32 | pkg install py39-openssl |
| 33 | pkg install py39-pysocks |
| 34 | pkg install py39-urllib3 |
| 35 | pkg install py39-yaml |
| 36 | ``` |
| 37 | |
| 38 | ## Install Netdata |
| 39 | |
| 40 | You can now install Netdata from the FreeBSD repository. |
| 41 | |
| 42 | ```bash |
| 43 | pkg install netdata |
| 44 | ``` |
| 45 | |
| 46 | :::warning |
| 47 | |
| 48 | If the above command returns a `Not Found` error, you need to manually search for the latest version of Netdata in the [FreeBSD repository](https://www.freebsd.org/ports/). Search for `netdata`, find the latest version number, and update the command accordingly. |
| 49 | |
| 50 | ::: |
| 51 | |
| 52 | You must edit `/usr/local/etc/netdata/netdata.conf` and change `bind to = 127.0.0.1` to `bind to = 0.0.0.0`. |
| 53 | |
| 54 | To start Netdata manually, run `service netdata onestart`. |
| 55 | |
| 56 | Visit the Netdata dashboard to confirm it's working: `http://<pfsenseIP>:19999` |
| 57 | |
| 58 | To start Netdata automatically every boot, add `service netdata onestart` as a Shellcmd entry within the pfSense web interface under **Services/Shellcmd**. You'll need to install the Shellcmd package beforehand under **System/Package Manager/Available Packages**. The Shellcmd Type should be set to `Shellcmd`. |
| 59 |  Alternatively, more information can be found in <https://doc.pfsense.org/index.php/Installing_FreeBSD_Packages>, for achieving the same via the command line and scripts. |
| 60 | |
| 61 | If you experience an issue with `/usr/bin/install` being absent in pfSense 2.3 or earlier, update pfSense or use a workaround from <https://redmine.pfsense.org/issues/6643> |
| 62 | |
| 63 | :::note |
| 64 | |
| 65 | In pfSense, the Netdata configuration files are located under `/usr/local/etc/netdata`. |
| 66 | |
| 67 | ::: |