blocky
Fast and lightweight DNS proxy as ad-blocker for local network with many features (alternative to Pi-hole).
← Back to all services
GitHub repository information
Fetched · June 5, 2026 ★ 6,673 Latest: v0.31.0 Updated: June 5, 2026
README
[](https://github.com/0xERR0R/blocky/actions/workflows/makefile.yml)
[](https://github.com/0xERR0R/blocky/actions/workflows/release.yml)
[](https://github.com/0xERR0R/blocky/releases)
[](https://github.com/0xERR0R/blocky/releases)
[](#)
[](https://hub.docker.com/r/spx01/blocky)
[](https://hub.docker.com/r/spx01/blocky)
[](https://codecov.io/gh/0xERR0R/blocky)
[](#)
[](https://goreportcard.com/report/github.com/0xERR0R/blocky)
[](https://ko-fi.com/0xerr0r)
[](https://liberapay.com/spx01)
<p align="center">
<img height="200" src="https://github.com/0xERR0R/blocky/blob/main/docs/blocky.svg">
</p>
# Blocky
Blocky is a DNS proxy and ad-blocker for the local network written in Go with following features:
## Features
- **Blocking** - Blocking of DNS queries with external lists (Ad-block, malware) and allowlisting
- Definition of allow/denylists per client group (Kids, Smart home devices, etc.)
- Periodical reload of external allow/denylists
- Regex support
- Blocking of request domain, response CNAME (deep CNAME inspection) and response IP addresses (against IP lists)
- **Advanced DNS configuration** - not just an ad-blocker
- Custom DNS resolution for certain domain names
- Conditional forwarding to external DNS server
- Upstream resolvers can be defined per client group
- **Performance** - Improves speed and performance in your network
- Customizable caching of DNS answers for queries -> improves DNS resolution speed and reduces amount of external DNS
queries
- Prefetching and caching of often used queries
- Using multiple external resolver simultaneously
- Low memory footprint
- **Various Protocols** - Supports modern DNS protocols
- DNS over UDP and TCP
- DNS over HTTPS (aka DoH)
- DNS over TLS (aka DoT)
- DNS over QUIC (aka DoQ, RFC 9250)
- DNS over HTTPS/3 (aka DoH3, RFC 9114)
- **Security and Privacy** - Secure communication
- Supports modern DNS extensions: DNSSEC, eDNS, ...
- DNSSEC validation of upstream resolvers
- Free configurable blocking lists - no hidden filtering etc.
- Provides DoH Endpoint
- Uses random upstream resolvers from the configuration - increases your privacy through the distribution of your DNS
traffic over multiple provider
- Blocky does **NOT** collect any user data, telemetry, statistics etc.
- **Integration** - various integration
- [Prometheus](https://prometheus.io/) metrics
- Prepared [Grafana](https://grafana.com/) dashboards (Prometheus and database)
- Logging of DNS queries per day / per client in CSV format or MySQL/MariaDB/PostgreSQL/Timescale database - easy to
analyze
- Various REST API endpoints
- CLI tool
- **Simple configuration** - single or multiple configuration files in YAML format
- Simple to maintain
- Simple to backup
- **Simple installation/configuration** - blocky was designed for simple installation
- Stateless (no database, no temporary files)
- Docker image with Multi-arch support
- Single binary
- Supports x86-64, ARM, and MIPS architectures -> runs fine on Raspberry PI and OpenWrt routers
- Community supported Helm chart for k8s deployment
## ❤️ Support Blocky
Blocky is **free, open source, and built entirely in my spare time** — with no telemetry, no data
collection, and no hidden filtering. It keeps the DNS for thousands of home networks, homelabs, and
businesses clean and private, and it always will.
Maintaining a project this size — fixing bugs, reviewing pull requests, shipping new features, and
keeping up with security — takes a lot of time. **Thousands of people run Blocky; only a handful
support it.** If Blocky is useful to you, please consider chipping in. Your support directly funds
ongoing development and helps keep Blocky independent and ad-free, forever.
Even a small recurring contribution makes a real difference and is hugely appreciated. 🙏
[](https://github.com/sponsors/0xERR0R)
[](https://thanks.dev/u/gh/0xERR0R)
[](https://liberapay.com/spx01)
[](https://ko-fi.com/0xerr0r)
[](https://paypal.me/spx01)
Thank you to everyone who supports Blocky! ❤️
## Quick start
You can jump to [Installation](https://0xerr0r.github.io/blocky/latest/installation/) chapter in the documentation.
## Full documentation
You can find full documentation and configuration examples
at: [https://0xERR0R.github.io/blocky/](https://0xERR0R.github.io/blocky/)
## Contribution
Issues, feature suggestions and pull requests are welcome!
[](https://ko-fi.com/G2G25XZQG)
Discover more
Knowledge-based community software. You can use it to quickly build your Q&A community for product technical support, customer support, user communication, and more.
6/5/2026 Details →
Powerful, enterprise-ready, open source web server with automatic HTTPS.
6/5/2026 Details →
Simple, easy-to-use, elegant Home Cloud system.
6/5/2026 Details →
Run server applications securely and with built-in privacy features. It acts as a secure gateway to your application, as well as a server manager.
6/5/2026 Details →
Highly customizable SSH server with several ways to authorize a user and options where and how to execute a user's session.
6/5/2026 Details →