brianpooe/homelab-blueprint
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs(dns): align technitium setup steps with zone-relative records

Browse source
This commit is contained in:
Brian Pooe 2026-03-01 19:39:44 +02:00
parent 71de685b1b
commit 54fe6dda98
3 changed files with 21 additions and 6 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

8
dns/end-to-end-migration-runbook.md
View file

@ -60,8 +60,12 @@ Reference:
- `http://192.168.60.6:5380`
2. Create primary zone `home.brianpooe.com`.
3. Add:
- `A` record: `caddy.home.brianpooe.com -> 192.168.10.5`
- wildcard `CNAME`: `*.home.brianpooe.com -> caddy.home.brianpooe.com`
- `A` record inside that zone:
- Name: `caddy` (FQDN: `caddy.home.brianpooe.com`)
- Address: `192.168.10.5`
- wildcard `CNAME` inside that zone:
- Name: `*` (FQDN: `*.home.brianpooe.com`)
- Target: `caddy.home.brianpooe.com`
4. Configure blocklist:
- `https://raw.githubusercontent.com/StevenBlack/hosts/master/hosts`
5. Add allowlist entry:

11
dns/technitium-cutover-checklist.md
View file

@ -12,6 +12,9 @@ You can replace most manual CNAMEs with:
This removes the need to add a new DNS record every time you add a new proxied service.
Technitium UI tip:
- When editing records inside zone `home.brianpooe.com`, use relative names (`caddy`, `*`) rather than full FQDN labels.
## Wildcard caveats (important)
- Wildcard does not cover the zone apex itself (`home.brianpooe.com`).
- Explicit records still override wildcard (this is good; you can keep special cases).
@ -60,8 +63,12 @@ A wildcard record closes this drift gap permanently.
#### Model A: wildcard-first (recommended)
Create only these core records first:
- `A` `caddy.home.brianpooe.com` -> `192.168.10.5`
- `CNAME` `*.home.brianpooe.com` -> `caddy.home.brianpooe.com`
- `A` record inside zone `home.brianpooe.com`:
- Name: `caddy` (FQDN `caddy.home.brianpooe.com`)
- Address: `192.168.10.5`
- `CNAME` record inside zone `home.brianpooe.com`:
- Name: `*` (FQDN `*.home.brianpooe.com`)
- Target: `caddy.home.brianpooe.com`
Optional explicit records for readability (not required if wildcard exists):
- `CNAME` `pihole.home.brianpooe.com` -> `caddy.home.brianpooe.com`

8
dns/technitium-dockhand-deployment.md
View file

@ -55,8 +55,12 @@ Open:
Then configure:
1. Create primary zone `home.brianpooe.com`.
2. Add `A` record: `caddy.home.brianpooe.com -> 192.168.10.5`.
3. Add wildcard `CNAME`: `*.home.brianpooe.com -> caddy.home.brianpooe.com`.
2. Add `A` record inside that zone:
- Name: `caddy` (FQDN: `caddy.home.brianpooe.com`)
- Address: `192.168.10.5`
3. Add wildcard `CNAME` inside that zone:
- Name: `*` (FQDN: `*.home.brianpooe.com`)
- Target: `caddy.home.brianpooe.com`
4. Add allowlist equivalent for `www.googleadservices.com`.
Reference details: