FlowAlp

Set up OPNsense / pfSense with Shift DNS

November 19, 2026

Step-by-step: let OPNsense / pfSense update your Shift DNS hostname automatically.

Both firewalls have a built-in dynamic DNS client. The field names differ a little; both are shown here.

You need a hostname and a token with the UPDATE permission. In the values below, replace your-hostname with your hostname and thdns_xxxxxxxx with your token.

Steps

  1. OPNsense: open Services, then Dynamic DNS, and add an entry with the values of the first table.
  2. pfSense: open Services, then Dynamic DNS, then the Dynamic DNS Clients tab, and add an entry with the values of the second table.
  3. Save and apply the changes.
FieldValue
OPNsense: ServiceCustom
OPNsense: Protocoldyndns2
OPNsense: Serverapi.shiftdns.thunderhosting.com
OPNsense: Usernameyour-hostname
OPNsense: Passwordthdns_xxxxxxxx
OPNsense: Hostname(s)your-hostname
OPNsense: Check ip methodInterface [default]
OPNsense: Force SSL✓
pfSense: Service TypeCustom
pfSense: Interface to monitorWAN
pfSense: Hostnameyour-hostname
pfSense: Usernameyour-hostname
pfSense: Passwordthdns_xxxxxxxx
pfSense: Update URLhttps://api.shiftdns.thunderhosting.com/nic/update?hostname=%HOSTNAME%&myip=%IP%
pfSense: Result Matchgood|nochg

After saving, trigger an update (or wait a few minutes) and check the hostname in the dashboard. If it does not work, see the troubleshooting article.