Genesis Docs

genesis dns

DNS helpers for wide-area discovery (Tailscale + CoreDNS). Currently focused on macOS + Homebrew CoreDNS.

Related:

Setup

genesis dns setup
genesis dns setup --domain genesis.internal
genesis dns setup --apply

dns setup

Plan or apply CoreDNS setup for unicast DNS-SD discovery.

Options:

  • --domain <domain>: wide-area discovery domain (for example genesis.internal)
  • --apply: install or update CoreDNS config and restart the service (requires sudo; macOS only)

What it shows:

  • resolved discovery domain
  • zone file path
  • current tailnet IPs
  • recommended genesis.json discovery config
  • the Tailscale Split DNS nameserver/domain values to set

Notes:

  • Without --apply, the command is a planning helper only and prints the recommended setup.
  • If --domain is omitted, Genesis uses discovery.wideArea.domain from config.
  • --apply currently supports macOS only and expects Homebrew CoreDNS.
  • --apply bootstraps the zone file if needed, ensures the CoreDNS import stanza exists, and restarts the coredns brew service.

Related