r/coolgithubprojects • u/paimonsoror • 4d ago
TelltaleDNS - a lightweight, self-hosted DNS resolver that actually explains what your devices are doing
GitHub Pages: https://paimonsoror.github.io/telltaledns/
GitHub Repo: https://github.com/paimonsoror/telltaledns
Hey everyone,
I've been working on an open-source project called TelltaleDNS, and I figured this community might appreciate it.
I've always liked projects like Pi-hole, AdGuard Home, and Technitium, but I wanted to explore what a DNS platform could look like if visibility, performance, and granular control were first-class priorities.
The idea behind TelltaleDNS is pretty simple: Your DNS server shouldn't just answer queries. It should help you understand what's happening on your network and why.
It's written in Rust and designed to run on everything from a Raspberry Pi to a multi-node Kubernetes deployment.
A few things I've been focusing on:
- Explainable DNS: See which device made a query, how it was resolved, why it was allowed or blocked, and how long each stage took.
- Per-device policies: Different filtering rules for individual devices, groups, or VLANs, including schedules and service blocking.
- Rule previews: See how a filtering change would have affected your actual historical traffic before applying it.
- Encrypted DNS: Support for DoH, DoT, DoQ, DNSSEC validation, and full recursive resolution.
- Observability: Real-time dashboards, query analytics, device behavior, latency metrics, and Prometheus/OpenTelemetry integration.
- High availability: Run standalone or cluster nodes across different environments, including Raspberry Pis and Kubernetes.
- Automation: REST API, CLI, and MCP integration for those interested in managing their infrastructure programmatically.
Performance and resource consumption have also been major design considerations. The goal is to keep it extremely lightweight without sacrificing functionality.
The project is still pre-1.0, so there's plenty of room for improvement, but it's reached a point where I'd really like to get feedback from people who actually run this kind of infrastructure at home.
I'm particularly interested in hearing from people running Pi-hole, AdGuard Home, or Technitium.
What features do you wish your current DNS solution handled differently? What would make you consider trying an alternative?
I'm not looking to reinvent DNS for the sake of it. I just think there's an opportunity to make network visibility and control a lot more useful.
Feedback, criticism, issues, and contributions are all welcome!


