Technitium DNS

DNS Hole

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

note

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 DNS Hole

Details

DNS Hole ControlsControl PiHole or AdGuard from your dashboard

Details

Adding the integration

You can find how to add the integration on the Integrations Management documentation page.

Secrets

info

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.

warning

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.

API Key

Name	Description
API Key	API Key from the service for authentication.

Steps to retrieve the credentials:

1. Open the Technitium DNS web console and sign in.
2. Click on your username in the top-right corner and select "Create API Token".
3. Give the token a name (e.g. "Homarr") and click "Create Token".
4. Copy the generated token and paste it into the API Key field in Homarr.

Username & Password

Name	Description
Username	Account username for authentication.
Password	Account password for authentication.

Enter your Technitium DNS admin credentials. Homarr will exchange them for a session token and transparently re-authenticate when the session expires.