Configuration for OPNsense (Firewall)

Important

To use DynDNS a DNS API user MUST exist. To do that follow the guide Create User in Customer Portal!

For all domain customers we offer a DynDNS service which communicates with the Servercow nameservers via the Servercow DNS API.

In the following article you will learn how to connect your OPNsense firewall to the DynDNS API of Servercow using the os-ddclient plugin.

---

Preparation

To use this integration you have to install the DDClient in the OPNsense first:

1. Log in to your firewall.
2. Go to the menu item: System Firmware Plugins and look for the plugin os-ddclient. Once you have found it, click on the small + icon.
3. Reload the page with a press on F5.
4. Switch to Services Dynamic DNS Settings in the menu.

5. Click on the tab General settings and activate the check mark at advanced mode. Activate the check mark Allow IPv6 if your OPNsense firewall also has a public IPv6 address.

   Debugging

   For better debugging, you can additionally check Verbose to get more detailed messages from the DynDNS plugin.

6. Save your changes by clicking on Apply.

---

Configuration

1. In the menu, switch to the DynDNS settings (usually under: Services Dynamic DNS Settings).
2. Select the tab Accounts and click on the small +.

3. Now enter the following in the fields:

   OPNsense DynDNS Field	Content to be entered
   Description	Name of your choice (e.g. DDNS Servercow dyndns.yourdomain.com)
   Service	Servercow
   Usaename	Your DNS API User
   Password	Your DNS API Password
   Hostname(s)	at least 1 Subdomain, which subdomain/domain to update via DynDNS (e.g. dyndns.yourdomain.com)
   Check ip method	dyndns
   Interface to monitor	The interface that owns the Dynamic IP address. Usually WAN
   Check ip timeout	10
   Force SSL

   Example configuration

   

4. Save your changes.

---

Now your OPNsense firewall should set its current IP address in DNS every 5 minutes.

Info

If the IP address has not changed, there is no change in the DNS!