DynDNS on VyOS: step-by-step setup
VyOS ships with a DynDNS2 client via its dynamic DNS service that can target any custom server. With DNS Beacon your router stays reachable under a permanent hostname even when your WAN IP changes. Here's how to configure it via the CLI.
Step by step
- Open the admin interface of your VyOS and go to CLI (configure).
- Enter the values below. Your username is your account email, your password is an API key from the dashboard.
- Save the settings. Your hostname now updates automatically whenever your IP changes — usually within a minute.
Settings to enter
CLI (configure)
- Protocol:
- dyndns2
- Server:
- api.dnsbeacon.com
- Hostname:
- myhouse.dnsfollowme.uk
- Login:
- your email address
- Password:
- your API key
- IPv6:
- VyOS 1.4+: create a separate name block for IPv6 (e.g. dnsbeacon6) and additionally set ip-version ipv6 there.
In the CLI: `set service dns dynamic name dnsbeacon protocol dyndns2`, then `server <API host>`, `host-name <hostname>`, `username <email>`, `password <API key>`, `address interface eth0` — then `commit; save`. On VyOS 1.2/1.3 the path is `service dns dynamic interface eth0 service …`.
IPv4 or IPv6?
The values above update the IPv4 address (A record) — the normal case on connections with their own public IPv4. For IPv6 (AAAA record) the device sends the parameter &myipv6=<IPv6> in addition or instead. How to do that on this device is in the "IPv6" row of the table.
DS-Lite or CGNAT (many cable and fibre connections): the router then has no public IPv4, and the service rejects a private WAN address with "abuse". In that case send only myipv6 — or use the DNS Beacon client directly on the target device, which detects both address families itself.
Need a free hostname first?
Create a free DNS Beacon account, add a hostname and generate an API key — then come back and finish the setup above.
Create free account