ZELYRA
SOFTWARE HANDBOOK · NETWORK TOOL

DynamicDNS
*.dyn.zelyra.eu

Complete practical guide for DynamicDNS: Dual-Stack IPv4/IPv6, custom domains via CNAME, Fritz!Box/ddclient/cURL configuration, /nic/update API, and optional HMAC-SHA256 webhooks.

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.eu address via a single CNAME record.
  • 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

  1. Sign in to the portal and open DynDNS → + Neuer Host (/app/tools/dyndns/neu).
  2. Enter a subdomain / hostname (a-z, 0-9, hyphens) to create <name>.dyn.zelyra.eu.
  3. Choose the record type (Dual-Stack recommended, IPv4-only, or IPv6-only).
  4. Optionally enter a custom domain via CNAME (e.g. vpn.yourcompany.com).
  5. 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.eu hostname is globally unique across tenants; reserved system names (www, ns, mail, admin, api, etc.) are protected.

3. Connecting a Custom Domain via CNAME

  1. Enter your custom subdomain (e.g. vpn.yourcompany.com) in Eigene Domain per CNAME (Optional).
  2. At your DNS provider (Strato, Hostinger, IONOS, Cloudflare, Netcup, etc.), create a single record:
    • Type: CNAME
    • Name: vpn
    • Target: <host>.dyn.zelyra.eu
  3. 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 (omit https://)

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.
PRODUCT OVERVIEW & PRICINGDynamicDNS (from €29/yr net) →