added manual secrets
This commit is contained in:
1 parent
672657c111
commit
d9cacefa0f
34 files changed
+1428
-10
No files matched your search
@@ -0,0 +1,39 @@
|
||||
# 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`.
|
||||
Reference in new issue
Block a user