Homarr
Technitium DNS logo

Technitium DNS

DNS Hole

Technitium DNS Server is a self-hosted DNS server with ad-blocking and network-wide filtering capabilities.

Homarr supports Technitium DNS v11 and above. The correct API version is detected automatically - no manual configuration is required.

Widgets & Capabilities

DNS Hole SummaryDisplays the summary of your Pi-hole, AdGuard Home or Technitium DNS blocks and queries statistics
View guide
DNS Hole ControlsControl the blocking feature of your Pi-hole, AdGuard Home or Technitium DNS from your dashboard
View guide

Adding the integration

Create the connection under Management → Integrations. See Managing integrations.

Secrets

The API token option is recommended. API tokens are non-expiring and do not require storing your admin password in Homarr. Username and password authentication uses a session token that expires after inactivity, triggering a silent re-login on the next request.

The DNS Hole Controls widget (enabling, disabling, and timed disabling of blocking) requires the token to have settings-level permissions. The DNS Hole Summary widget (stats only) works with any valid token. If Homarr cannot read the blocking status due to insufficient permissions, the status indicator will be hidden but statistics will still be shown.

On this page