PKR-Lab

Design: Wildcard-DNS für `*.homeserver`

Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-core/archiv/superpowers/specs/2026-05-22-wildcard-dns-homeserver-design.md

Design: Wildcard-DNS für *.homeserver

Datum: 2026-05-22

Problem

Neue ArgoCD-Apps mit Ingress sind im Homelab (LAN + Tailnet) nicht automatisch per DNS erreichbar. Jede neue App erfordert bisher:

  1. Eintrag in dnsmasq_hosts in capulus-ansible/group_vars/all.yml
  2. Ausführen von make dnsmasq

Ziel

Jede App, die mit einem *.homeserver-Ingress im Cluster deployed wird, ist ohne manuellen Schritt sofort per DNS erreichbar.

Entscheidung

Wildcard-DNS-Eintrag in dnsmasq statt expliziter Einträge pro Service.

Verworfene Alternativen:

Änderungen

capulus-ansible/roles/dnsmasq/templates/dnsmasq.conf.j2

Die {% for host in dnsmasq_hosts %}-Schleife entfällt. Ersatz:

address=/homeserver/{{ network_static_ip }}

dnsmasq matcht damit homeserver und alle Subdomains (*.homeserver) → network_static_ip. Traefik routet den eingehenden Traffic per Ingress-Hostname zum richtigen Service.

capulus-ansible/group_vars/all.yml

Der dnsmasq_hosts:-Block wird entfernt. Die Variable ist nach der Änderung unbenutzt.

Was sich nicht ändert

Deploy

make dnsmasq

dnsmasq wird mit der neuen Konfiguration neu gestartet. Kein weiterer Schritt nötig.