hemsby/tdns-stats

tdns-stats is a self-hosted web dashboard for monitoring Technitium DNS Server, a free DNS server application people run on their own machines to control how domain name lookups work on their network. If you run one or more Technitium DNS servers, this dashboard gives you a browser-based view of what they are doing in near real time. The dashboard shows a live feed of DNS queries as they come in, statistics for each server individually and for clusters of servers, lists of the most frequently queried domains and most active clients, and performance metrics like cache hit rate and response time. Updates are pushed to the browser automatically using a technology called Server-Sent Events, so the page stays current without you needing to refresh it. You connect the dashboard to your Technitium servers by editing a YAML configuration file with each server's address and API token. The token is created in the Technitium web interface under Administration. Multiple servers can be added, and if they are configured as a cluster, the dashboard automatically adds a combined view showing aggregate stats across all nodes alongside the individual server tabs. The project can be run three ways: as a Node.js process started from the command line, as a Docker container, or as a background service managed by the operating system (systemd on Linux). There is also a built-in update checker: a version number appears in the corner of the interface, and clicking it checks for newer releases on GitHub. If an update is available, you can apply it from the browser and the service restarts automatically. The live query feed requires an additional query log app to be installed on each Technitium server (SQLite, MySQL, PostgreSQL, or SQL Server options are supported). Without it, the per-server statistics and top lists still work, but the real-time feed and response time metrics are unavailable. The interface supports light, dark, and system-matched themes.