CoreWarden is the Kubernetes-native ad-blocking DNS server for your homelab. Check out the documentation.

Key Features • Getting Started • Contribution

Key features

• Headless operation, designed to be managed via configs and API.
• Supports high availability and rolling upgrades.
• Fine grained authorization for record editing.
• Built-in DOT support for encrypted DNS lookups.
• Built-in Prometheus metrics exporting and structured logging for easy use with observability tools.
• Official External DNS provider.

What it is not

• It is not an authoritative server. It is not designed for being the nameserver for your domains.
• It is not a recursive resolver.

Why not Adguard, PiHole or Technitium?

I've been using PiHole and Adguard for the past few years. However, I found them less than ideal for running on Kubernetes.

• They don't provide Helm charts or Kubernetes manifests.
• They don't export Prometheus metrics.
• They aren't designed for high availability and rolling deployments.

Read more about the reasoning in the documentation.

Getting started

Read the getting started guide for installation on Kubernetes with Helm.

Contribution

See the development instructions in the documentation. If you want to learn more about how the project works, check out the architecture page.