Skip to content

Configuration

ovx-labs edited this page Sep 5, 2026 · 1 revision

Configuration

/etc/agentic-dns/ — Service Configs

Generated by install.sh, editable for custom zones/upstreams:

File Purpose
dnsdist.conf Routing rules, load balancing, Lua policies
Corefile CoreDNS zones, plugins
unbound.conf Recursive resolver settings
stubby.yml DoT upstream certificates
dnscrypt-proxy.toml DoH server stamps

Environment Variables

Variable Default Description
PIHOLE_HOST 127.0.0.1 Pi-hole API address
PIHOLE_API_KEY /etc/pihole/pihole-api-key.txt Pi-hole API key
AGENTIC_DNS_API_PORT 8099 REST API port
VPN_DNS auto Override VPN DNS
AGENTIC_DNS_SERVER_BIN agentic-dns-server Rust server binary

Pi-hole API Key

# Auto-detected from /etc/pihole/pihole-api-key.txt
# Or set manually:
export PIHOLE_API_KEY="your-api-key"

Clone this wiki locally