Deploy Now

Stars

386

Forks

18

Watchers

2

Developer links

TelltaleDNS

Every connection your devices make starts with a DNS lookup, and TelltaleDNS is the resolver that answers it, filters it per device, and explains exactly why it answered that way. The query log ties each question to a named device, using names from your router's leases, mDNS, or the UI, times every stage, and a Why panel shows the list and rule behind each block. Groups per network or VLAN carry their own blocklists, schedules, safe search, blocked services, and rewrites, and a new rule can be previewed against yesterday's real traffic before you save it. Serve devices over DoT, DoH, or DoQ, give each one a client ID that follows it onto mobile data, forward to encrypted upstreams, validate DNSSEC, or resolve recursively from the root servers. The dashboard adds a traffic map, a heatmap of when your network asks, a flow diagram from groups to answers, and anomaly alerts, with Prometheus metrics, OpenTelemetry, and dnstap for your SIEM. A Raspberry Pi and Kubernetes nodes can share one configuration, with canary rollouts, automatic failover, and failover drills. It answers queries only from private and Tailscale address ranges unless you widen that, and it imports Pi-hole and Technitium setups. A REST API, command line, and MCP tools with approval serve scripts and agents. Running on a dedicated VPS on RepoCloud with guaranteed CPU, RAM, and SSD, full root SSH access, and a browser serial console. Apache-2.0 or MIT licensed.

TelltaleDNS
TelltaleDNS
TelltaleDNS
TelltaleDNS
TelltaleDNS
TelltaleDNS
TelltaleDNS
TelltaleDNS

Benefits

  • Know Who Asked And Why
  • Every query is attributed to a named device and timed per stage, and a Why panel names the exact list and rule that decided each answer, so blocks are never a mystery.
  • Test Rules Before You Save
  • Preview a new blocklist or rule against yesterday's real traffic to see what it would have blocked, allowed, or rerouted for each device, before any change reaches your network.
  • Stays Up When Parts Fail
  • DNS keeps answering from its last good configuration even if the control plane is down, and a witness lets a replica take over automatically across a Pi and Kubernetes.
  • Never An Open Resolver By Default
  • Queries from outside private and Tailscale address ranges are refused unless you widen the allowed networks, so a resolver on a VPS does not become an open relay by accident.

Features

  • Explained Query Log
  • A searchable log ties each query to a named device, times every stage, and a Why panel names the list and rule behind each block or allow.
  • Per-Device Filtering Rules
  • Groups for each network or VLAN get their own blocklists, schedules, safe search, blocked services, rewrites, and upstreams, in hosts, AdGuard, or Pi-hole regex formats.
  • Encrypted DNS Both Ways
  • Serve devices over DoT, DoH, and DoQ with per-device client IDs, forward to encrypted upstreams, validate DNSSEC, or resolve recursively from the root servers.
  • Traffic Maps And Heatmaps
  • A dashboard, traffic map, heatmap, and flow diagram show what your network asks and when, with anomaly alerts, Prometheus metrics, and OpenTelemetry export.
  • Clusters Across Pi And Kubernetes
  • Share one configuration across a Raspberry Pi and Kubernetes nodes, send changes to canary nodes first, run failover drills, and see pods named by workload.
  • API, CLI, And MCP Tools
  • A documented REST API with OpenAPI, a telltale ctl command line, and MCP tools with plans and approval let scripts and AI agents manage rules safely.

Apps Similar to TelltaleDNS