Software Handbook: DynamicDNS (*.dyn.zelyra.eu)
1. Overview & Architecture
The DynamicDNS module in the Siedelmann Business Suite provides a GDPR-compliant DynamicDNS infrastructure powered by an authoritative PowerDNS server hosted in Germany.
- Base domain: All new hosts are created automatically under
*.dyn.zelyra.eu(e.g.office.dyn.zelyra.eu). - Dual-Stack: Supports IPv4 (
A), IPv6 (AAAA), or Dual-Stack (IPv4 + IPv6) with a fast 60-second TTL. - Custom Domain (CNAME): Point any custom subdomain (e.g.
vpn.yourcompany.com) to your*.dyn.zelyra.euaddress via a singleCNAMErecord. - Standalone licensing: Try DynamicDNS free for 14 days (no auto-renewal) and upgrade monthly (
€3.90 net/month) or yearly (€29.00 net/year) via PayPal.
2. Quick Start & Creating Your First Host
- Sign in to the portal and open DynDNS → + Neuer Host (
/app/tools/dyndns/neu). - Enter a subdomain / hostname (
a-z,0-9, hyphens) to create<name>.dyn.zelyra.eu. - Choose the record type (Dual-Stack recommended, IPv4-only, or IPv6-only).
- Optionally enter a custom domain via CNAME (e.g.
vpn.yourcompany.com). - Save to generate your secret update token (
dyn_...) and ready-to-copy router snippets.
- Fair-use quota: Up to 10 hosts included per paid tenant (3 hosts in trial). Need more? Request additional domains free of charge via the in-app support link.
- Global uniqueness: Each
*.dyn.zelyra.euhostname is globally unique across tenants; reserved system names (www,ns,mail,admin,api, etc.) are protected.
3. Connecting a Custom Domain via CNAME
- Enter your custom subdomain (e.g.
vpn.yourcompany.com) in Eigene Domain per CNAME (Optional). - At your DNS provider (Strato, Hostinger, IONOS, Cloudflare, Netcup, etc.), create a single record:
- Type:
CNAME - Name:
vpn - Target:
<host>.dyn.zelyra.eu
- Type:
- Click DNS-Eintrag jetzt prüfen on the host detail page to verify the CNAME live.
4. Business Firewalls, Routers & Clients (Setup)
Our update endpoint is fully DynDNS2-compatible (/nic/update, HTTP Basic Auth or query token):
- Update URL:
https://siedelmann.com/nic/update(or JSON API/api/v1/dyndns/update) - IP check endpoint:
https://siedelmann.com/nic/checkip - Server host:
siedelmann.com
4.1 AVM Fritz!Box
- Update URL:
https://siedelmann.com/nic/update?hostname=<domain>&myip=<ipaddr>&myipv6=<ip6addr> - Domain / Username:
office.dyn.zelyra.eu· Password: your secret token (dyn_...)
4.2 OPNsense (os-ddclient)
- Service:
Custom· Protocol:DynDns2· Server:siedelmann.com - Username / Hostname:
office.dyn.zelyra.eu· Password: your secret token (dyn_...)
4.3 pfSense
- Service Type:
Custom· Update URL:https://siedelmann.com/nic/update?hostname=office.dyn.zelyra.eu&myip=%IP% - Result Match:
good %IP%|nochg %IP%
4.4 Ubiquiti UniFi (UDM / UDM Pro / UXG)
- Service:
custom· Hostname / Username:office.dyn.zelyra.eu· Password: your secret token - Server:
siedelmann.com/nic/update?hostname=%h&myip=%i(omithttps://)
4.5 Sophos Firewall (SFOS / XG / XGS)
- Provider: Custom / DynDNS2 · Hostname / Username:
office.dyn.zelyra.eu· Password: your secret token
4.6 Fortinet FortiGate (FortiOS CLI)
config system ddns
edit 1
set monitor-interface "wan1"
set ddns-server genericDDNS
set ddns-server-addr "siedelmann.com"
set ddns-domain "office.dyn.zelyra.eu"
set ddns-username "office.dyn.zelyra.eu"
set ddns-password "YOUR_TOKEN"
set use-public-ip enable
next
end
4.7 LANCOM Systems (LCOS)
- Action Table (
Connect):https://siedelmann.com/nic/update?token=YOUR_TOKEN&hostname=office.dyn.zelyra.eu&myip=%a
4.8 MikroTik RouterOS & Synology DSM
- MikroTik:
/tool fetch mode=https url="https://siedelmann.com/nic/update?hostname=office.dyn.zelyra.eu" user="office.dyn.zelyra.eu" password="YOUR_TOKEN" keep-result=no - Synology DSM (Custom DDNS):
https://siedelmann.com/nic/update?hostname=__HOSTNAME__&myip=__MYIP__&token=__PASSWORD__
4.9 Linux (cURL & ddclient)
curl -4 "https://siedelmann.com/nic/update?token=YOUR_TOKEN"
curl -6 "https://siedelmann.com/nic/update?token=YOUR_TOKEN"
Standard response codes: good <IP>, nochg <IP>, badauth, nohost, abuse.
5. Webhook & External Automation (Optional)
Optional HTTP POST webhook fired on every IP change (JSON payload with hostname, old/new IPv4 & IPv6, timestamp). If a Webhook Secret is set, each request is signed via X-DynDNS-Signature (HMAC-SHA256).
6. Security, Log Retention & GDPR
- One-click token rotation invalidates previous tokens immediately.
- Update logs are retained for 30 days and pruned automatically.
- Hosted in Germany; GDPR DPA (Art. 28) PDF is available directly in the portal.
