# Install blocky with Homebrew, apk, Nix Fast and lightweight DNS proxy as ad-blocker for local network. Version 0.33.0 via Homebrew; verified 2026-06-30. ## Install ```sh sudo av install brew:blocky ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install blocky ``` Evidence: local Homebrew formula metadata ### Linux - apk (92%): ```sh sudo apk add blocky ``` Evidence: Alpine Linux edge package indexes: blocky from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz - Nix (92%): ```sh nix profile install nixpkgs#blocky ``` Evidence: nixpkgs package indexes: pkgs/by-name/bl/blocky/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ## Package facts - **Package key:** brew:blocky - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.33.0 - **Source summary:** Fast and lightweight DNS proxy as ad-blocker for local network - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** Apache-2.0 - **Source archive:** - **Last updated:** 2026-06-30T09:18:06Z - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - blocky (cli) - blocky (alias) ## Build dependencies - go ## Install behavior - Post-install hook: not defined - Service: declared - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 0.33.0 - Package-manager updated: 2026-06-30 - Local data: ok - Upstream repository: https://github.com/0xerr0r/blocky - Upstream latest detected: v0.33.0 (current) ## Project history and usage blocky is a Go DNS proxy and ad blocker for local networks. It belongs to the self-hosted DNS-adblocking family, but its package identity is a single binary with YAML configuration, modern encrypted DNS protocols, metrics, and router/Raspberry Pi friendly deployment. ### Project history GitHub metadata dates blocky's repository to November 2019. The official README describes it as a fast, lightweight DNS proxy and ad blocker for local networks, written in Go, with blocking lists, allowlists, conditional forwarding, caching, DNSSEC-related features, Prometheus/Grafana integration, REST endpoints, and a CLI. The README emphasizes simple operation: stateless behavior, no required database, Docker multi-arch images, a single binary, and support for x86-64, ARM, and MIPS. The docs describe YAML configuration, folder-based multi-file config merging, and generated JSON schema validation. ### Adoption history blocky's adoption tracks the home-network and homelab move from appliance-style ad blockers to packaged, containerized, and declarative DNS services. The input metadata records packages in Alpine apk, Homebrew, and Nix, while the README advertises Docker pulls and multi-architecture deployment. The release stream is active: official releases include v0.32.1 on June 20, 2026, with several 0.30-plus releases earlier in 2026. ### How it is used Operators run blocky as a DNS service and configure upstream resolvers, blocklists, allowlists, ports, logging, privacy options, and protocol support in YAML. The official configuration docs explain `config.yaml`, `config.yml`, and using `--config` to point at a folder of `.yml` or `.yaml` files that are merged in lexical order. ### Why package nerds care blocky is interesting to package people because it packages an infrastructure service like a normal CLI: one Go binary, config schema, validation command, system-service-friendly behavior, and no mandatory database. That makes it easy to slot into Homebrew, Nix, Alpine, containers, routers, and homelab automation. It also sits in the same practical category as Pi-hole and AdGuard Home while keeping a config-file-first shape that appeals to users who prefer declarative package-managed systems. ### Timeline - 2019: Official GitHub repository created. - Early release line: Tags begin with v0.2.0 in the public repository. - 2026: v0.32.1 released on June 20 after several active 2026 releases. ### Related projects - Pi-hole and AdGuard Home are related local-network DNS blocking projects. - Prometheus and Grafana are named integrations in the README. - DNS-over-HTTPS, DNS-over-TLS, DNS-over-QUIC, DNSSEC, and OpenWrt/Raspberry Pi deployments are adjacent ecosystem pieces named by the official docs and README. ### Sources - GitHub repository metadata via gh api repos/0xerr0r/blocky - - - - - - source_facts.package-manager ## Security Notes formula declares a Homebrew service. - **Geiger risk:** orange / medium - formula declares a Homebrew service ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: config.yaml, config.yml, folder passed to --config containing *.yml, *.yaml files ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** blocky - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Nix - blocky: normalized package name match | nixpkgs package indexes: pkgs/by-name/bl/blocky/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - apk - blocky - 0.30.0-r0: normalized package name match | Alpine Linux edge package indexes: blocky from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | DNS proxy ad-blocker for local network | https://github.com/0xERR0R/blocky - apk - blocky-openrc - 0.30.0-r0: normalized package name match | Alpine Linux edge package indexes: blocky-openrc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | DNS proxy ad-blocker for local network (OpenRC init scripts) | https://github.com/0xERR0R/blocky ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew. - [ctrld](https://www.automicvault.com/pkg/brew/ctrld/) - Shares av.db curated category or tags: cli, dns, networking, proxy. - [dnscrypt-proxy](https://www.automicvault.com/pkg/brew/dnscrypt-proxy/) - Shares av.db curated category or tags: cli, dns, networking, proxy. - [dnscrypt-wrapper](https://www.automicvault.com/pkg/brew/dnscrypt-wrapper/) - Shares av.db curated category or tags: cli, dns, networking, proxy. - [glider](https://www.automicvault.com/pkg/brew/glider/) - Shares av.db curated category or tags: cli, dns, networking, proxy. - [adns](https://www.automicvault.com/pkg/brew/adns/) - Shares av.db curated category or tags: cli, dns, networking. - [aliddns](https://www.automicvault.com/pkg/brew/aliddns/) - Shares av.db curated category or tags: cli, dns, networking. - [bind](https://www.automicvault.com/pkg/brew/bind/) - Shares av.db curated category or tags: cli, dns, networking. - [brook](https://www.automicvault.com/pkg/brew/brook/) - Shares av.db curated category or tags: cli, networking, proxy. ## Combined YAML source View the package source record on GitHub. [combined/blocky.yml](https://github.com/automic-vault/db/blob/main/combined/blocky.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph