Install adam:ONE on pfSense

The following versions of pfSense are currently supported by adam:ONE (formerly known as DNSthingy)

pfSense Version AMD64 ARM ARM64
2.4.x Yes Yes Yes (no cloud backup)
2.3.x No

Step 1 - Install adam:ONE Package

Sign in to your pfSense web admin and navigate to Diagnostics / Command Prompt.

Under the “Execute Shell Command” section copy and paste the following command:

curl -sS https://dl.adamnet.works/pfsense/install | sh

Beta version

If you are interested in installing the pre-release channel use this command instead.

curl -sS https://dl.adamnet.works/pfsense/install-beta | sh

Step 2 - Disable DNS Resolver

From the pfSense WebGUI navigate to Services / DNS Resolver.
Uncheck the Enable box and Save / Apply Changes.

You may want to also add your gateway IP as the DNS server in your pfSense DHCP server under Services / DHCP Server

Step 3 - Change your webConfigurator port

From the pfSense WebGUI navigate to System / Advanced,

Ensure that you are using HTTPS if it isn’t already, and set the TCP port to a non-standard port such as 20443.

Note that the URL of your pfSense WebGUI will change after saving this, so you may want to update any bookmark or shortcut if you have one.

Step 4 - Enable adam:ONE Service

From the pfSense WebGUI navigate to Services / adam:ONE.

Check the Enable box, click Save, and then Apply Changes.

This will configure and start the adam:ONE service. Use the Box ID listed here to link this installation to your Dashboard account.

Step 5 - Manage your settings on the Dashboard

Go to https://dashboard.adamnet.works to sign up using your Box ID or add it to an existing account by creating a new network.


How to Remove adam:ONE from pfSense

Sign in to your pfSense WebGUI and navigate to Diagnostics / Command Prompt.

Under the “Execute Shell Command” section copy and paste the following command.

pkg remove -y dnsthingy