Home

azure-ddns — Azure DNS Dynamic Updater

Welkom bij de azure-ddns wiki. Deze documentatie is bedoeld voor de beheerder die azure-ddns installeert, configureert en beheert op een Raspberry Pi.

Navigatie

• Architectuur — Hoe het script werkt (flow, componenten, API calls)
• Installatie — Stap-voor-stap installatie op Raspberry Pi
• Azure configuratie — Service Principal aanmaken en rechten toekennen
• Operationeel beheer — Cron jobs, monitoring, logrotate, updates
• Troubleshooting — Exit codes, veelvoorkomende fouten en oplossingen

Wat is azure-ddns?

azure-ddns is een lightweight bash script dat als DDNS-client werkt voor Azure DNS. Het detecteert het publieke IP-adres van je netwerk en update automatisch een A-record in Azure DNS wanneer het IP verandert.

Kenmerken:

• Geen dependencies buiten bash, curl en jq
• OAuth2 authenticatie via Azure Service Principal
• Automatische IP-fallback (icanhazip.com → checkip.amazonaws.com)
• IPv4 validatie, flock locking, verbose debug modus
• Ontworpen voor onbeheerde cron-uitvoering op een Raspberry Pi

Snel aan de slag

Zie de README voor een quick start, of volg de wiki-pagina's in volgorde:

1. Azure configuratie — eenmalig
2. Installatie — eenmalig
3. Operationeel beheer — doorlopend