ZELYRA HANDBOOK

Complete Language Guide & Technical Reference
Zelyra 1.3.1 (Commit e20d099)
Official Documentation · Stefan Siedelmann
https://siedelmann.com · November 2026

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.


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.

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):

4.1 AVM Fritz!Box

4.2 OPNsense (os-ddclient)

4.3 pfSense

4.4 Ubiquiti UniFi (UDM / UDM Pro / UXG)

4.5 Sophos Firewall (SFOS / XG / XGS)

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)

4.8 MikroTik RouterOS & Synology DSM

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