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
- OPNsense: open Services, then Dynamic DNS, and add an entry with the values of the first table.
- pfSense: open Services, then Dynamic DNS, then the Dynamic DNS Clients tab, and add an entry with the values of the second table.
- Save and apply the changes.
| Field | Value |
|---|---|
| OPNsense: Service | Custom |
| OPNsense: Protocol | dyndns2 |
| OPNsense: Server | api.shiftdns.thunderhosting.com |
| OPNsense: Username | your-hostname |
| OPNsense: Password | thdns_xxxxxxxx |
| OPNsense: Hostname(s) | your-hostname |
| OPNsense: Check ip method | Interface [default] |
| OPNsense: Force SSL | ✓ |
| pfSense: Service Type | Custom |
| pfSense: Interface to monitor | WAN |
| pfSense: Hostname | your-hostname |
| pfSense: Username | your-hostname |
| pfSense: Password | thdns_xxxxxxxx |
| pfSense: Update URL | https://api.shiftdns.thunderhosting.com/nic/update?hostname=%HOSTNAME%&myip=%IP% |
| pfSense: Result Match | good|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.