DynDNS on Linux: the native client
The native Linux client keeps your hostname pointed at your machine's public IP automatically — a systemd service that runs from boot with no user logged in. There are packages for Debian/Ubuntu and Fedora/RHEL plus a tarball for everything else, each for x86-64, ARM64 and ARMv7 (Raspberry Pi).
Step by step
- Download the matching package from the Downloads page (dashboard → “Downloads”) and install it — via dpkg, rpm, or install.sh from the extracted tarball.
- Run sudo dnsbeacon-client configure — it prompts for the hostname and API key (dyndns_…, from the dashboard); the key input stays hidden.
- Apply the configuration with sudo systemctl restart dnsbeacon-client. Check the state with dnsbeacon-client status and the log with journalctl -u dnsbeacon-client; the parameters below cover special cases like IPv6-only.
Settings to enter
Terminal
- Install:
- download the package from the Downloads page (dashboard → Downloads): sudo dpkg -i dnsbeacon-client_*.deb, sudo rpm -i dnsbeacon-client-*.rpm, or sudo sh install.sh from the tarball
- Configure:
- sudo dnsbeacon-client configure --hostname myhouse.dnsfollowme.uk
- --hostname <fqdn>:
- hostname to keep updated
- --interval <min>:
- minutes between IP checks (default 5)
- --ipv4 / --no-ipv4:
- update IPv4 (A record) — default on
- --ipv6 / --no-ipv6:
- update IPv6 (AAAA record) — default off; --no-ipv4 --ipv6 for IPv6-only (e.g. DS-Lite)
- --api-key-stdin:
- read the API key from stdin (for scripting); without it you get a hidden prompt
- Apply:
- sudo systemctl restart dnsbeacon-client
- Verify:
- dnsbeacon-client status or sudo dnsbeacon-client once --force
- Log:
- journalctl -u dnsbeacon-client -f
The API key is a dyndns_… key from the dashboard — account passwords are rejected by the server. The client runs as a systemd service under root and updates from boot even with no user logged in. It keeps itself up to date, taking the same route it was installed by (dpkg, rpm, or a binary swap). For systems without dpkg/rpm — Alpine, Arch, NAS firmware — there is a tarball with install.sh; the binary is statically linked and has no dependencies.
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