Hilfe & Anleitungen
Einrichtungsanleitungen für Router, DNS-Anbieter und die API.
Loslegen
- Konto erstellen und E-Mail-Adresse bestätigen.
- Gehe im Dashboard zu Hostnamen → Anlegen und füge eine Subdomain wie
myhouse.dnsfollowme.ukhinzu. - Erstelle im Tab API-Keys einen API-Key (z. B. "Fritz!Box Wohnzimmer") und kopiere ihn sicher — er wird nur einmal angezeigt.
- Konfiguriere deinen Router gemäß Router einrichten — verwende den API-Key als Passwort.
Router einrichten
Lieber ein Programm auf dem Gerät installieren, statt den Router zu konfigurieren? Dafür gibt es die nativen Clients.
IPv4 oder IPv6?
Die Werte oben aktualisieren die IPv4-Adresse (A-Record) – der Normalfall an Anschlüssen mit eigener öffentlicher IPv4. Für IPv6 (AAAA-Record) schickt das Gerät zusätzlich oder stattdessen den Parameter &myipv6=<IPv6>. Wie das bei diesem Gerät geht, steht in der Zeile „IPv6“ der Tabelle.
DS-Lite oder CGNAT (viele Kabel- und Glasfaseranschlüsse): Der Router hat dann keine öffentliche IPv4, und eine private WAN-Adresse lehnt der Dienst mit „abuse“ ab. Sende in dem Fall nur myipv6 – oder nutze den DNS-Beacon-Client direkt auf dem Zielgerät, der beide Adressfamilien selbst erkennt.
Fritz!Box (AVM)
Internet → Freigaben → DynDNS
- Anbieter:
- Benutzerdefiniert
- Update-URL:
- https://api.dnsbeacon.com/nic/update?hostname=<domain>&myip=<ipaddr>
- Domainname:
- myhouse.dnsfollowme.uk
- Benutzername:
- deine E-Mail-Adresse
- Kennwort:
- dein API-Key
- IPv6:
- Platzhalter <ip6addr>. Dual-Stack: an die Update-URL &myipv6=<ip6addr> anhängen. DS-Lite: nur ?hostname=<domain>&myipv6=<ip6addr> senden, ohne <ipaddr>.
Synology NAS
Systemsteuerung → Externer Zugriff → DDNS → Hinzufügen
- Anbieter:
- Benutzerdefiniert
- Hostname:
- myhouse.dnsfollowme.uk
- Benutzername:
- deine E-Mail-Adresse
- Kennwort:
- dein API-Key
- Server-URL:
- https://api.dnsbeacon.com/nic/update?hostname=__HOSTNAME__&myip=__MYIP__
- IPv6:
- DSM 7: Platzhalter __MYIPV6__ – an die Server-URL &myipv6=__MYIPV6__ anhängen (bei DS-Lite &myip=__MYIP__ weglassen). Ältere DSM-Versionen kennen den Platzhalter nicht.
Ubiquiti UniFi
Settings → Internet → WAN → Dynamic DNS
- Service:
- custom (oder dyndns)
- Hostname:
- myhouse.dnsfollowme.uk
- Username:
- deine E-Mail-Adresse
- Password:
- dein API-Key
- Server:
- api.dnsbeacon.com/nic/update?hostname=%h&myip=%i
- IPv6:
- Nur IPv4 – UniFi OS unterstützt keine AAAA-Updates. Für IPv6 den DNS-Beacon-Client direkt auf dem Zielgerät einsetzen.
Hinweis: UniFi sendet Updates nur, wenn sich die WAN-IP tatsächlich ändert. Um ein Update zu erzwingen, deaktiviere die DynDNS-Konfiguration, speichere, aktiviere sie wieder, speichere.
Ausführliche Anleitung →pfSense / OPNsense
Services → Dynamic DNS → Add
- Service type:
- Custom
- Update-URL:
- https://api.dnsbeacon.com/nic/update?hostname=%h&myip=%IP%
- Hostname:
- myhouse.dnsfollowme.uk
- Username:
- deine E-Mail-Adresse
- Password:
- dein API-Key
- IPv6:
- Zweiten Eintrag mit Service Type „Custom (v6)“ anlegen, Update-URL dort mit &myipv6=%IP% statt &myip=%IP%.
OpenWrt
Services → Dynamic DNS
- Anbieter:
- -- custom --
- Update-URL:
- https://api.dnsbeacon.com/nic/update?hostname=[DOMAIN]&myip=[IP]
- Domainname:
- myhouse.dnsfollowme.uk
- Benutzername:
- deine E-Mail-Adresse
- Kennwort:
- dein API-Key
- IPv6:
- Zweite DDNS-Konfiguration mit IP-Adressversion IPv6 (use_ipv6) anlegen, Update-URL dort mit &myipv6=[IP] statt &myip=[IP].
Installiere zuerst das Paket luci-app-ddns (System → Software bzw. opkg install luci-app-ddns ddns-scripts). OpenWrt ersetzt [DOMAIN] und [IP] in der URL automatisch.
Ausführliche Anleitung →OPNsense
Services → Dynamic DNS → Settings
- Service type:
- Custom
- Server:
- api.dnsbeacon.com
- Benutzername:
- deine E-Mail-Adresse
- Kennwort:
- dein API-Key
- Hostname:
- myhouse.dnsfollowme.uk
- IPv6:
- Zweiten Account nur für IPv6 anlegen: „Check ip method“ auf einen IPv6-Dienst stellen und unter General Settings „Allow IPv6“ aktivieren.
Installiere zuerst das Plugin os-ddclient (System → Firmware → Plugins) und wähle den Dienst Custom – er sendet Standard-DynDNS2-Updates an /nic/update.
Ausführliche Anleitung →DD-WRT
Services → DDNS
- Service:
- Custom
- Server:
- api.dnsbeacon.com
- Update-URL:
- /nic/update?hostname=
- Hostname:
- myhouse.dnsfollowme.uk
- Benutzername:
- deine E-Mail-Adresse
- Kennwort:
- dein API-Key
- IPv6:
- Nur IPv4 – die DDNS-Oberfläche sendet nur die IPv4, IPv6 ginge nur per eigenem Cron-Skript. Für IPv6 den DNS-Beacon-Client direkt auf dem Zielgerät einsetzen.
Setze den DDNS Service auf Custom. DD-WRT hängt deinen Hostnamen und die aktuelle IP automatisch an die URL an.
Ausführliche Anleitung →TP-Link Omada
Settings → Services → Dynamic DNS (bzw. Device Config → DNS → Dynamic DNS)
- Service Provider:
- Custom
- Update URL:
- https://api.dnsbeacon.com/nic/update?hostname=[DOMAIN]&myip=[IP]
- Domain Name:
- myhouse.dnsfollowme.uk
- Username:
- deine E-Mail-Adresse
- Password:
- dein API-Key
- IPv6:
- Nur IPv4 – Omada-DDNS unterstützt derzeit keine IPv6-Updates. Für IPv6 den DNS-Beacon-Client direkt auf dem Zielgerät einsetzen.
Funktioniert ab Omada Controller v5 und Gateway-Firmware mit Custom-DDNS-Eintrag (ER605, ER7206 etc.). Wähle als Service Provider „Custom" und lege einen neuen Dynamic-DNS-Eintrag an – Omada ersetzt [DOMAIN], [IP], [USERNAME] und [PASSWORD] in der URL automatisch.
Ausführliche Anleitung →Aruba Instant
Configuration → Services → Dynamic DNS
- Provider:
- DynDNS
- URL:
- https://api.dnsbeacon.com/nic/update?hostname=<h>&myip=<a>
- Hostname:
- myhouse.dnsfollowme.uk
- Username:
- deine E-Mail-Adresse
- Password:
- dein API-Key
- IPv6:
- Nur IPv4 – Aruba Instant On unterstützt kein DDNS mit IPv6. Für IPv6 den DNS-Beacon-Client direkt auf dem Zielgerät einsetzen.
Aruba Instant (ArubaOS 8.x+) erlaubt eigene DDNS-Profile. Setze in der WebUI bzw. via CLI (`dynamic-dns` / `ddns-profile`) als Provider „DynDNS" und überschreibe die URL, damit Updates an die DNS-Beacon-API gehen. Aruba ersetzt <h> durch den Hostnamen und <a> durch die aktuelle IP.
Ausführliche Anleitung →LANCOM
Kommunikation → Allgemein → Aktionen-Tabelle (LANconfig)
- Aktion (URL):
- https://api.dnsbeacon.com/nic/update?hostname=%h&myip=%a
- Hostname:
- myhouse.dnsfollowme.uk
- Benutzername:
- deine E-Mail-Adresse
- Kennwort:
- dein API-Key
- IPv6:
- Platzhalter %z. Dual-Stack: &myipv6=%z an die Aktions-URL anhängen. DS-Lite: nur ?hostname=%h&myipv6=%z verwenden.
Lege in LANconfig unter Kommunikation → Allgemein → Aktionen-Tabelle eine neue Aktion an, die bei „Established" bzw. IP-Wechsel ausgelöst wird. LANCOM ersetzt %h durch den Hostnamen und %a durch die aktuelle IPv4 (für IPv6 %z verwenden). Betten deine Zugangsdaten als `https://<Benutzername>:<API-Key>@…` in die URL ein.
Ausführliche Anleitung →DrayTek Vigor
Applications → Dynamic DNS Setup
- Service Provider:
- User-Defined
- Provider Host:
- api.dnsbeacon.com
- Service API:
- /nic/update?hostname=myhouse.dnsfollowme.uk&myip=###IP###
- Domain Name:
- myhouse.dnsfollowme.uk
- Login-Konto:
- deine E-Mail-Adresse
- Kennwort:
- dein API-Key
- IPv6:
- Nur IPv4 – Customized DDNS liefert mit ###IP### nur die WAN-IPv4. Für IPv6 den DNS-Beacon-Client direkt auf dem Zielgerät einsetzen.
Wähle als Service Provider „User-Defined". DrayTek ersetzt ###IP### automatisch durch die aktuelle WAN-IP; Login-Konto und Kennwort werden als HTTP-Basic-Auth an /nic/update gesendet. Stelle „Determine Real WAN IP" auf „WAN IP", wenn der Router direkt am Internet hängt.
Ausführliche Anleitung →Ubiquiti EdgeRouter
CLI (configure) – oder GUI: Services → DNS → Dynamic DNS
- Protokoll:
- dyndns2
- Server:
- api.dnsbeacon.com
- Hostname:
- myhouse.dnsfollowme.uk
- Login:
- deine E-Mail-Adresse
- Kennwort:
- dein API-Key
- IPv6:
- Nur IPv4 – der ddclient von EdgeOS unterstützt AAAA-Updates nicht zuverlässig. Für IPv6 den DNS-Beacon-Client direkt auf dem Zielgerät einsetzen.
EdgeOS nutzt ddclient. In der CLI: `set service dns dynamic interface eth0 service custom-dnsbeacon protocol dyndns2`, dann `server <API-Host>`, `host-name <Hostname>`, `login <E-Mail>`, `password <API-Key>` – anschließend `commit; save`. Ersetze eth0 durch dein WAN-Interface.
Ausführliche Anleitung →FortiGate
Network → DNS → Dynamic DNS
- Server:
- genericDDNS
- Server-Adresse:
- api.dnsbeacon.com
- Domain:
- myhouse.dnsfollowme.uk
- Benutzername:
- deine E-Mail-Adresse
- Kennwort:
- dein API-Key
- IPv6:
- FortiOS 7.0+: zweiten DDNS-Eintrag mit server-type ipv6 und addr-type ipv6 anlegen.
FortiOS unterstützt seit Version 6.x den Server-Typ „genericDDNS", der den Standard-DynDNS2-Endpunkt /nic/update auf einem frei wählbaren Server aufruft. In der CLI: `config system ddns` → `set ddns-server genericDDNS`, `set ddns-server-addr` mit der API-Adresse, `set ddns-domain` mit deinem Hostnamen, `ddns-username`/`ddns-password` für die Authentifizierung. Das Monitor-Interface auf das WAN-Interface setzen.
Ausführliche Anleitung →bintec elmeg
Lokale Dienste → DynDNS-Client → DynDNS-Provider → Neu
- Server:
- api.dnsbeacon.com
- Update-URL:
- /nic/update?hostname=<domain>&myip=<ipaddr>
- Hostname:
- myhouse.dnsfollowme.uk
- Benutzername:
- deine E-Mail-Adresse
- Kennwort:
- dein API-Key
- IPv6:
- Ab Firmware 10.2.5 meldet der DynDNS-Client auch IPv6 (inkl. DS-Lite) – IPv6-Option im Provider-Eintrag aktivieren, Platzhalter laut Firmware-Hilfe.
Lege unter Lokale Dienste → DynDNS-Client → DynDNS-Provider einen neuen Provider mit diesem Server und dieser Update-URL an. bintec ersetzt <domain> durch den Hostnamen und <ipaddr> durch die aktuelle WAN-IP; Benutzername und Kennwort werden zur Authentifizierung gesendet. Anschließend in der DynDNS-Registrierung diesen Provider auswählen.
Ausführliche Anleitung →Zyxel USG FLEX / ATP
Configuration → System → DDNS
- DDNS Provider:
- User customize
- Server / Host:
- api.dnsbeacon.com
- URL:
- /nic/update?hostname=<domain>&myip=<ipaddr>
- Domain Name:
- myhouse.dnsfollowme.uk
- Username:
- deine E-Mail-Adresse
- Password:
- dein API-Key
- IPv6:
- Nur IPv4 – die DDNS-Funktion von ZLD meldet nur die IPv4 des WAN-Interfaces. Für IPv6 den DNS-Beacon-Client direkt auf dem Zielgerät einsetzen.
Wähle als DDNS Provider „User customize". Zyxel ersetzt <domain> durch den Domain Name und <ipaddr> durch die WAN-IP; Username und Password gehen als Authentifizierung an /nic/update. Das abschließende „?" in der URL ist erforderlich.
Ausführliche Anleitung →Peplink Balance
Network → WAN → [Verbindung] → Dynamic DNS Settings
- Service:
- custom (User-defined)
- Server:
- api.dnsbeacon.com
- Hostname:
- myhouse.dnsfollowme.uk
- Username:
- deine E-Mail-Adresse
- Password:
- dein API-Key
- IPv6:
- Nur IPv4 – Peplinks DDNS meldet keine IPv6-Adressen. Für IPv6 den DNS-Beacon-Client direkt auf dem Zielgerät einsetzen.
Ab Firmware 6.3 kannst du unter Dynamic DNS Settings einen eigenen DDNS-Server angeben. Die Custom-Option spricht das DynDNS-Protokoll – trage als Server den API-Host ein. Benutzername ist deine E-Mail, Passwort ein API-Key.
Ausführliche Anleitung →VyOS
CLI (configure)
- Protokoll:
- dyndns2
- Server:
- api.dnsbeacon.com
- Hostname:
- myhouse.dnsfollowme.uk
- Login:
- deine E-Mail-Adresse
- Kennwort:
- dein API-Key
- IPv6:
- VyOS 1.4+: eigenen name-Block für IPv6 anlegen (z. B. dnsbeacon6) und dort zusätzlich ip-version ipv6 setzen.
In der CLI: `set service dns dynamic name dnsbeacon protocol dyndns2`, dann `server <API-Host>`, `host-name <Hostname>`, `username <E-Mail>`, `password <API-Key>`, `address interface eth0` – anschließend `commit; save`. Bei VyOS 1.2/1.3 lautet der Pfad `service dns dynamic interface eth0 service …`.
Ausführliche Anleitung →MikroTik RouterOS
System → Scripts und System → Scheduler (WinBox oder Terminal)
- WAN-Interface:
- Interface mit der öffentlichen IP, z. B. ether1 oder pppoe-out1 (im Skript statt ether1 eintragen)
- Hostname:
- myhouse.dnsfollowme.uk
- Benutzername:
- deine E-Mail-Adresse (im Skript als <email>)
- Kennwort:
- dein API-Key (im Skript als <api-key>)
- Skript, Zeile 1:
- :local a [/ip address get [find interface=ether1] address]; :local ip [:pick $a 0 [:find $a "/"]]
- Skript, Zeile 2:
- :local r [/tool fetch url="https://api.dnsbeacon.com/nic/update?hostname=myhouse.dnsfollowme.uk&myip=$ip" user="<email>" password="<api-key>" output=user as-value]; :log info ("dnsbeacon: " . ($r->"data"))
- Scheduler:
- /system scheduler add name=dnsbeacon interval=5m on-event=dnsbeacon policy=read,write,test
- IPv6:
- In Zeile 1 /ip address durch /ipv6 address und [find interface=ether1] durch [find interface=ether1 global] ersetzen, in Zeile 2 &myipv6=$ip statt &myip=$ip senden.
RouterOS hat keinen eingebauten DynDNS2-Client – IP Cloud spricht nur MikroTiks eigenen Dienst. Deshalb übernimmt ein Zwei-Zeilen-Skript das Update: Zeile 1 liest die IP des WAN-Interfaces, Zeile 2 ruft /nic/update per /tool fetch mit HTTP-Basic-Auth auf und schreibt die Antwort ins Log. Bei DSL/PPPoE heißt das WAN-Interface meist pppoe-out1. Hinter CGNAT/DS-Lite ist die WAN-IP privat und per IPv4 ohnehin nicht erreichbar – dann stattdessen myipv6 mit der globalen IPv6-Adresse senden. Gilt für RouterOS 7 (und 6.45+).
Ausführliche Anleitung →Andere Geräte (DynDNS2-kompatibel)
Jedes Gerät, das DynDNS2 spricht, funktioniert mit folgenden Einstellungen:
- Update-URL:
- https://api.dnsbeacon.com/nic/update?hostname=<host>&myip=<ip>
- Auth:
- Basic Auth (E-Mail / API-Key)
- IPv6 (optional):
- zusätzlicher Parameter &myipv6=<ipv6>
Native Update-Clients
BetaEin schlanker Update-Client, der direkt auf dem Gerät läuft — ideal für Notebooks, Workstations und Server, die ihre öffentliche IP melden sollen, ohne dass der Router die DynDNS-Konfiguration übernimmt. Für Windows, macOS und Linux verfügbar.
- ✓Status auf einen Blick — Tray-Symbol unter Windows, Menüleisten-Icon unter macOS, der Befehl dnsbeacon-client status unter Linux: letzter Update-Zeitpunkt, gemeldete IP, nächster Lauf.
- ✓Automatischer Start beim Boot, kein manuelles Anstoßen nötig; Updates laufen im Hintergrund.
- ✓Erkennt IPv4 und IPv6 separat und kann beide Adressfamilien parallel aktuell halten.
- ✓Signierte Installer: MSI für Windows, notarisiertes pkg für macOS (Universal). Für Linux deb, rpm oder ein statisches Binary für x86-64, ARM64 und ARMv7.
Alle drei Clients stehen im Dashboard unter Downloads bereit; die Anleitungen unten beschreiben die Einrichtung Schritt für Schritt.
Windows-Client
Tray-Symbol → Einstellungen
- Installation:
- MSI von der Downloads-Seite laden (Dashboard → Downloads) und installieren
- Hostname:
- myhouse.dnsfollowme.uk
- API-Key:
- dyndns_…-Key aus dem Dashboard (Eingabe maskiert)
- Intervall:
- Minuten zwischen den IP-Prüfungen (Standard 5)
- IPv4 (A):
- Checkbox „IPv4 (A) aktualisieren“ — Standard an
- IPv6 (AAAA):
- Checkbox „IPv6 (AAAA) aktualisieren“ — für reines IPv6 (DS-Lite) IPv4 abwählen
- Dienst:
- Windows-Dienst aktualisiert auch ohne angemeldeten Benutzer
Der API-Key ist ein dyndns_…-Key aus dem Dashboard — Account-Passwörter lehnt der Server ab. Der Dienst hält sich per Auto-Update aktuell; die Tray-App zeigt Status und letzte IP.
Ausführliche Anleitung →macOS-Client
Terminal
- Installation:
- pkg von der Downloads-Seite laden (Dashboard → Downloads) und per Doppelklick installieren
- Einrichten:
- sudo dnsbeacon-client configure --hostname myhouse.dnsfollowme.uk
- --hostname <fqdn>:
- Hostname, der aktuell gehalten wird
- --interval <min>:
- Minuten zwischen den IP-Prüfungen (Standard 5)
- --ipv4 / --no-ipv4:
- IPv4 (A-Record) aktualisieren — Standard an
- --ipv6 / --no-ipv6:
- IPv6 (AAAA-Record) aktualisieren — Standard aus; --no-ipv4 --ipv6 für reines IPv6 (z.B. DS-Lite)
- --api-key-stdin:
- API-Key von stdin lesen (für Skripte); ohne Flag wird er unsichtbar abgefragt
- Übernehmen:
- sudo launchctl kickstart -k system/com.dnsbeacon.client
- Prüfen:
- dnsbeacon-client status bzw. sudo dnsbeacon-client once --force
- Log:
- /Library/Logs/DynDnsClient/daemon.log
Der API-Key ist ein dyndns_…-Key aus dem Dashboard — Account-Passwörter lehnt der Server ab. Nach der Installation zeigt das „DNS Beacon“-Icon in der Menüleiste den Status; der Daemon läuft als launchd-Dienst auch ohne angemeldeten Benutzer und hält sich per Auto-Update aktuell.
Ausführliche Anleitung →Linux-Client
Terminal
- Installation:
- Paket von der Downloads-Seite laden (Dashboard → Downloads): sudo dpkg -i dnsbeacon-client_*.deb, sudo rpm -i dnsbeacon-client-*.rpm oder sudo sh install.sh aus dem Tarball
- Einrichten:
- sudo dnsbeacon-client configure --hostname myhouse.dnsfollowme.uk
- --hostname <fqdn>:
- Hostname, der aktuell gehalten wird
- --interval <min>:
- Minuten zwischen den IP-Prüfungen (Standard 5)
- --ipv4 / --no-ipv4:
- IPv4 (A-Record) aktualisieren — Standard an
- --ipv6 / --no-ipv6:
- IPv6 (AAAA-Record) aktualisieren — Standard aus; --no-ipv4 --ipv6 für reines IPv6 (z.B. DS-Lite)
- --api-key-stdin:
- API-Key von stdin lesen (für Skripte); ohne Flag wird er unsichtbar abgefragt
- Übernehmen:
- sudo systemctl restart dnsbeacon-client
- Prüfen:
- dnsbeacon-client status bzw. sudo dnsbeacon-client once --force
- Log:
- journalctl -u dnsbeacon-client -f
Der API-Key ist ein dyndns_…-Key aus dem Dashboard — Account-Passwörter lehnt der Server ab. Der Client läuft als systemd-Dienst unter root und aktualisiert ab Boot auch ohne angemeldeten Benutzer. Er hält sich per Auto-Update aktuell, und zwar auf demselben Weg, auf dem er installiert wurde (dpkg, rpm oder Binary-Tausch). Für Systeme ohne dpkg/rpm — Alpine, Arch, NAS-Firmware — gibt es ein Tarball mit install.sh; das Binary ist statisch gelinkt und hat keine Abhängigkeiten.
Ausführliche Anleitung →Eigene Domain verwenden
Du kannst eine Domain anbinden, die du selbst bei einem unterstützten DNS-Anbieter hostest. Dein API-Token wird AES-256-GCM-verschlüsselt gespeichert und ausschließlich zum Aktualisieren der DNS-Einträge dieser Domain verwendet.
Cloudflare
Voraussetzung: Die Domain ist zu Cloudflare delegiert (Nameserver zeigen auf Cloudflare).
- Auf dash.cloudflare.com/profile/api-tokens einen Token erstellen.
- Verwende die Vorlage "Edit zone DNS" — Berechtigungen:
Zone:DNS:Edit. - Unter Zone Resources wähle entweder Specific zone → deine-domain.de oder All zones.
- Kopiere den Token und füge ihn im Dashboard unter Domains → Domain hinzufügen ein.
Hetzner DNS
Voraussetzung: Die Domain ist als Zone in der Hetzner-DNS-Konsole eingerichtet.
- Auf dns.hetzner.com/settings/api-token einen API-Token erstellen.
- Token kopieren — er wird nur einmal angezeigt.
- Wähle im Dashboard unter Domains → Domain hinzufügen den Anbieter "Hetzner DNS" und füge den Token ein.
united-domains
Voraussetzung: Das kostenpflichtige Add-on DNS-API ist für die Zone bei united-domains aktiviert. Ohne dieses liefert der Token keine Zonen.
- Buche das DNS-API-Add-on im united-domains-Portfolio.
- Generiere den API-Key in deinem Kundenkonto.
- Wähle im Dashboard unter Domains → Domain hinzufügen den Anbieter "united-domains" und füge den Key ein.
Rate-Limit: 1.200 Anfragen/Stunde pro Token.
IONOS
Voraussetzung: Die Domain ist in deinem IONOS-Account angelegt und der API-Zugriff ist über das Developer-Portal aktiviert.
- Öffne developer.hosting.ionos.de/keys und erstelle ein neues Schlüsselpaar (Public Prefix + Secret).
- Kopiere den kombinierten Token im Format "<prefix>.<secret>" — dieser wird nur einmal angezeigt.
- Wähle im Dashboard unter Domains → Domain hinzufügen den Anbieter "IONOS" und füge den kombinierten Token ein.
TXT-Records werden unterstützt — Let's-Encrypt-Zertifikate über DNS-01 funktionieren auf IONOS-Zonen.
INWX
Voraussetzung: Die Domain ist in deinem INWX-Account angelegt.
- Logge dich in den INWX-Kundenbereich ein und lege unter "Konto → Benutzerverwaltung" einen API-Sub-User ohne 2FA an.
- Notiere Benutzername und Passwort des Sub-Users.
- Wähle im Dashboard unter Domains → Domain hinzufügen den Anbieter "INWX" und gib Benutzername und Passwort ein.
Wichtig: Der INWX-API-Login schlägt fehl, wenn das Konto Mobile-TAN-2FA aktiv hat. Lege deshalb einen separaten Sub-User ohne 2FA an — dein Hauptkonto kann (und sollte) 2FA behalten.
netcup
Voraussetzung: Die Domain läuft über deinen netcup-Account.
- Lege im netcup Customer Control Panel unter "Stammdaten ändern → API" ein neues API-Key-Paar an.
- Notiere Kundennummer, API-Key und API-Passwort (das Passwort wird nur einmal angezeigt).
- Wähle im Dashboard unter Domains → Domain hinzufügen den Anbieter "netcup" und füge alle drei Werte ein.
Hinweis: Die netcup-API arbeitet recordset-basiert (jede Änderung ersetzt das gesamte Record-Set). Wenn du parallel im CCP manuell DNS-Einträge bearbeitest, während wir einen TXT-Record für Let's Encrypt setzen, kann eine Änderung verloren gehen. Bei normalem Betrieb (DynDNS-Updates, Cert-Renewals) ist das unkritisch.
OVHcloud
Voraussetzung: Die Domain liegt in deinem OVHcloud-Account, und du benutzt den europäischen Endpoint (eu.api.ovh.com).
- Lege auf ovh.com/auth/api/createApp eine neue API-Application an — du bekommst Application-Key und Application-Secret.
- Öffne den OVH Token Maker, gib Application-Key und Secret ein und generiere einen Consumer-Key.
- Wichtig: gib dem Consumer-Key folgende Rechte (jeweils GET, POST, PUT, DELETE auf
/domain/zone/*), bestätige im OVH-Account und kopiere den ausgegebenen Consumer-Key. - Wähle im Dashboard unter Domains → Domain hinzufügen den Anbieter "OVHcloud" und füge alle drei Werte ein.
Hinweis: Wir nutzen standardmäßig den EU-Endpoint. Für CA-/US-Accounts ist eine andere Base-URL nötig — bitte vorab Bescheid geben.
deSEC
Voraussetzung: Du hast einen kostenlosen Account bei deSEC.io und eine Zone dort angelegt.
- Lege auf desec.io/tokens einen neuen API-Token an.
- Kopiere den Token sofort — er wird nur einmal angezeigt.
- Wähle im Dashboard unter Domains → Domain hinzufügen den Anbieter "deSEC" und füge den Token ein.
deSEC ist ACME-DNS-01-freundlich; Let's-Encrypt-Zertifikate funktionieren ohne Sonderkonfiguration.
Gandi
Voraussetzung: Die Domain liegt in deinem Gandi-Account.
- Öffne admin.gandi.net und logge dich ein.
- Unter Authentication options → Personal Access Tokens lege ein neues Token mit der Berechtigung "Manage DNS records" an.
- Wähle im Dashboard unter Domains → Domain hinzufügen den Anbieter "Gandi" und füge den Token ein.
Gandi-LiveDNS erzwingt eine Mindest-TTL von 300 Sekunden. Wir setzen das automatisch hoch.
Mittwald
Voraussetzung: Du hast einen Mittwald-Account mit einem Projekt und die Domain ist dort als DNS-Zone angelegt.
- Lege im mStudio unter Profil → API-Tokens einen neuen Token mit Schreibrechten auf DNS-Zonen an.
- Notiere zusätzlich die Project-ID (UUID) des Projekts, das die Zone enthält — sichtbar in der mStudio-URL.
- Wähle im Dashboard unter Domains → Domain hinzufügen den Anbieter "Mittwald" und füge API-Token und Project-ID ein.
Hinweis: Mittwald legt für jeden Subdomain-Eintrag eine eigene "DNS Zone" im Projekt an (Sub-Zone-Delegation). Für 10 DynDNS-Hosts ergeben sich 10 Sub-Zonen — funktional unkritisch, im mStudio-UI aber sichtbar.
Infomaniak
Voraussetzung: Die Domain liegt in deinem Infomaniak-Manager-Account.
- Öffne Manager → Profil → API-Schlüssel und lege einen Token mit Bereich "Domain" an.
- Notiere den Token (wird nur einmal angezeigt).
- Wähle im Dashboard unter Domains → Domain hinzufügen den Anbieter "Infomaniak" und füge den Token ein.
Infomaniak unterstützt TXT-Records nativ — Let's-Encrypt-Zertifikate über DNS-01 funktionieren ohne Sonderkonfiguration.
Scaleway
Voraussetzung: Die Domain ist über Scaleway registriert und liegt in deinem Account.
- Lege in der Scaleway-Konsole unter IAM → API-Keys einen neuen API-Key an.
- Notiere den "Secret Key" — den Access Key brauchen wir nicht.
- Wähle im Dashboard unter Domains → Domain hinzufügen den Anbieter "Scaleway" und füge den Secret Key ein.
Scaleway nutzt ein PATCH-basiertes Änderungs-Modell — Operationen sind atomar pro Request. Let's-Encrypt-DNS-01 funktioniert nativ.
API & Endpunkte
DynDNS2-Endpunkt
Der router-kompatible Update-Endpunkt:
GET https://api.dnsbeacon.com/nic/update?hostname=<host>[&myip=<ipv4>][&myipv6=<ipv6>] Authorization: Basic base64(<email>:<api-key>)
Mögliche Antworten:
| good <ip> | Update angenommen |
| nochg <ip> | IP unverändert, kein DNS-Update nötig |
| nohost | Hostname existiert nicht oder ist inaktiv |
| badauth | E-Mail oder API-Key ist falsch |
| badparam | Ungültige Parameter (z. B. fehlerhafte IP) |
| abuse | IP-Adresse als Ziel nicht erlaubt (reservierter Bereich oder regionale Sperre) — nicht erneut versuchen |
| 911 | Serverfehler — später erneut versuchen |
Test mit curl
curl -u "you@example.com:dyndns_..." \ "https://api.dnsbeacon.com/nic/update?hostname=myhouse.dnsfollowme.uk&myip=1.2.3.4"
Automatisches SSL für deine Hostnamen
Ein-Klick-Zertifikate über Let's Encrypt — direkt aus dem Dashboard, ohne ACME-Client, ohne Konfiguration auf deiner Seite. Funktioniert für Subdomains auf unserer Domain und für deine eigene Domain (BYOD).
- ✓Ein-Klick-Ausstellung direkt aus dem Dashboard — funktioniert für Subdomains auf unserer Domain und für deine eigene Domain (BYOD).
- ✓Automatische Verlängerung im Hintergrund; das aktuelle Zertifikat steht jederzeit als Download bereit.
- ✓DNS-01-Validierung — kein offener Port 80 nötig, funktioniert auch für Geräte hinter NAT oder DS-Lite.
- ✓CAA-Pinning sorgt dafür, dass nur autorisierte CAs Zertifikate für deine Hostnamen ausstellen können.
Erfordert einen PRO- oder BUSINESS-Plan.
FAQ
Mein Router sendet keine Updates — was tun?▼
Die meisten Router (UniFi, Fritz!Box) senden Updates nur, wenn sich die WAN-IP tatsächlich ändert. Um eines zu erzwingen, deaktiviere die DynDNS-Konfiguration im Router, speichere, aktiviere sie wieder, speichere. Im Tab Hostnamen → Verlauf im Dashboard siehst du, ob Updates ankommen.
Wie verwende ich meinen API-Key?▼
Trage ihn im Router als Passwort statt deines Konto-Passworts ein. Die E-Mail bleibt als Benutzername. Du kannst den API-Key jederzeit widerrufen, ohne dein Konto-Passwort zu ändern.
Kann ich IPv6 nutzen?▼
Ja. Hänge "&myipv6=<deine-ipv6>" an die Update-URL an — der Dienst legt zusätzlich zum A-Record einen AAAA-Record an. Free- und Pro-Pläne können beides parallel nutzen.
Was, wenn ich meinen API-Key verliere?▼
API-Keys werden nur als Hash gespeichert und können nicht wiederhergestellt werden. Lösche den alten Key im Dashboard, erstelle einen neuen und aktualisiere deinen Router.
Wie viele Hostnamen/Domains kann ich anlegen?▼
Free: 3 Hostnamen, 1 eigene Domain, 3 API-Keys. Pro: unbegrenzt. Business: unbegrenzt + Team-Login.
Was ist Domain-Verifizierung?▼
Wenn du eine eigene Domain hinzufügst, ruft der Dienst mit dem hinterlegten Token den DNS-Anbieter auf und prüft, ob die Zone existiert und der Token Zugriff hat. Klappt das, wird die Domain als verifiziert markiert und kann sofort genutzt werden.
Wie aktiviere ich Zwei-Faktor-Authentifizierung?▼
Unter Einstellungen → Zwei-Faktor-Authentifizierung. Während der Einrichtung zeigt der Dienst einen QR-Code, den du mit Google Authenticator, Authy, Bitwarden oder 1Password scannst. Beim Aktivieren bekommst du 8 Einweg-Backup-Codes — bewahre sie sicher auf. API-Keys für /nic/update sind von 2FA nicht betroffen — Router brauchen weiterhin nur E-Mail + API-Key.