About
TechnitiumDNS is a custom integration that connects a Technitium DNS server to Home Assistant and reports DNS statistics. It adds sensors for total and blocked queries, clients, top clients and domains, response result totals, zone counts, cached entries and whether an update is available. It also provides switches, with the ad-blocking switch needing modify permission on the API user, plus buttons and presence tracking. Options cover DHCP device tracking with an IP filter, DNS log tracking, activity analysis and the statistics update interval. Setup asks for the server URL, an API token, a display name and a statistics time window, with choices for SSL checking and cluster aggregate statistics. It works locally and is set up in the interface.
Automatic summary of the README and code of Atlas-Commons/home-assistant-technitiumdns. Something wrong, or are you the maintainer and want your own text here? Get in touch
Supports
Works locally Talks to your devices on your own network. No vendor cloud in between.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.
Provides
- Switches
- Sensors
- Presence
Setting it up
Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.
Configure TechnitiumDNS
- URLBase URL of your Technitium DNS server API (including port)
- Check SSL
- API keyAPI token from the Technitium DNS web console
- UsernameTechnitium DNS web UI username
- Server NameShort display label for this server — used in entity and device names, not the API hostname
- Statistics DurationTime window for dashboard statistics
- Use cluster aggregate statistics
After setup
- Enable DHCP Device Tracking
- DHCP Update Interval (seconds)
- IP Filter Mode
- IP Addresses/Ranges (comma or newline separated)
- Enable DNS Log Tracking
- Staleness Threshold (minutes)
- Enable Smart Activity Analysis
- Activity Score Threshold (points)
- Activity Analysis Window (minutes)
- Test DHCP Connection
- Statistics Update Interval (seconds)
- DHCP Test Results
Texts from the code of Atlas-Commons/home-assistant-technitiumdns.
From the README
Contributions welcome — see CONTRIBUTING.md. PRs require DCO sign-off (git commit -s).
This custom integration allows you to integrate technitiumDNS with Home Assistant, providing sensors for various DNS statistics.
Shows in Vulpo
Quick Toggle card, Button card, Chart card, Apple Watch, Control Center.Information
- Installs
- 344 sharing analytics
- GitHub stars
- 92
- Connection
- Works locally
- Upkeep
- Updated in the last 6 months
- Version
- v3.0.0,
- Category
- Computers and network, Routers and network
- Kind
- Marketplace integration
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
technitiumdns- Issues
- Report an issue












