> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fased.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# dns

# `fased dns`

DNS helpers for wide-area discovery, mainly around Tailscale plus CoreDNS. The
current guidance is centered on the macOS and Homebrew CoreDNS path.

Related:

* Gateway discovery: [Discovery](/gateway/discovery)
* Wide-area discovery config: [Configuration](/gateway/configuration)

## Setup

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
fased dns setup
fased dns setup --domain fased.internal
fased dns setup --apply
```

Without `--apply`, the command prints the recommended discovery config and the
Tailscale split-DNS settings to apply. With `--apply`, it installs or updates the
local CoreDNS config and restarts CoreDNS with `sudo`; that apply path is
currently macOS-only.

Options:

* `--domain <domain>`: discovery domain to serve, overriding `discovery.wideArea.domain`.
* `--apply`: write CoreDNS config and restart the service.