Files
2026-06-26 16:07:47 -04:00

1.7 KiB

modules/nixos/server/dns/

Local DNS and certificate infrastructure for the *.lab.internal / *.internal homelab. default.nix imports the three independent submodules below.

Structure

dns/
├── default.nix   # imports routing/ + certbot/ + local-ca/
├── routing/      # skyg.server.dns.routing — dnsmasq resolver + static A records
├── certbot/      # skyg.server.dns.certbot — Let's Encrypt via certbot + nginx
└── local-ca/     # skyg.server.dns.local-ca — internal certificate authority scaffolding

Notable details

  • routing/ runs dnsmasq, generating exact + wildcard address= entries from addresses, forwarding the rest to upstreamServers (default 1.1.1.1/1.0.0.1). It can also pull additional address= lines from an agenix secret named via addressesSecretName (decrypted into a conf-file).
  • certbot/ wires up daily certbot renew --nginx, with a testMode dry-run option and a certbot-get-certs shell alias built from publicDomains + email.
  • local-ca/ sets up the directory/structure for an internal CA; the actual key/cert generation is currently scaffolded (commented openssl steps) rather than fully implemented.

Option Namespace

skyg.server.dns.routing.{enable,addresses,addressesSecretName,upstreamServers,listenAddresses,openFirewall}
skyg.server.dns.certbot.{enable,publicDomains,email,testMode}
skyg.server.dns.local-ca.{enable,caCert,caKey,domain,organization,...}

Conventions

  • The three submodules are independent; enable only what a host needs.
  • DNS records that must stay private should live in the agenix secret referenced by addressesSecretName, not in plaintext addresses.