{"id":36644017,"url":"https://github.com/robocopklaus/hassio-addon-blocky","last_synced_at":"2026-02-28T16:01:00.847Z","repository":{"id":187073715,"uuid":"676096045","full_name":"robocopklaus/hassio-addon-blocky","owner":"robocopklaus","description":"Efficient DNS proxy and ad-blocker for Home Assistant, offering customizable filtering, advanced DNS settings, and modern protocol support for enhanced network security and performance.","archived":false,"fork":false,"pushed_at":"2026-02-22T17:37:33.000Z","size":276,"stargazers_count":11,"open_issues_count":1,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-22T19:44:06.795Z","etag":null,"topics":["blocky","dns","home-assistant","home-assistant-addons"],"latest_commit_sha":null,"homepage":"","language":"Groovy","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/robocopklaus.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-08-08T12:25:46.000Z","updated_at":"2026-02-22T17:37:35.000Z","dependencies_parsed_at":"2026-01-01T00:07:10.554Z","dependency_job_id":null,"html_url":"https://github.com/robocopklaus/hassio-addon-blocky","commit_stats":null,"previous_names":["robocopklaus/hassio-addon-blocky"],"tags_count":8,"template":false,"template_full_name":"home-assistant/addons-example","purl":"pkg:github/robocopklaus/hassio-addon-blocky","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robocopklaus%2Fhassio-addon-blocky","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robocopklaus%2Fhassio-addon-blocky/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robocopklaus%2Fhassio-addon-blocky/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robocopklaus%2Fhassio-addon-blocky/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/robocopklaus","download_url":"https://codeload.github.com/robocopklaus/hassio-addon-blocky/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robocopklaus%2Fhassio-addon-blocky/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29941794,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-28T13:49:17.081Z","status":"ssl_error","status_checked_at":"2026-02-28T13:48:50.396Z","response_time":90,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blocky","dns","home-assistant","home-assistant-addons"],"created_at":"2026-01-12T09:56:20.074Z","updated_at":"2026-02-28T16:01:00.798Z","avatar_url":"https://github.com/robocopklaus.png","language":"Groovy","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg height=\"200\" src=\"https://raw.githubusercontent.com/0xERR0R/blocky/main/docs/blocky.svg\"\u003e\n  \u003ch1\u003eBlocky Home Assistant Add-On\u003c/h1\u003e\n  \u003cp\u003eA powerful DNS proxy and ad-blocker for your Home Assistant ecosystem.\u003c/p\u003e\n\n  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n  ![Supports amd64 Architecture](https://img.shields.io/badge/amd64-yes-green.svg)\n  ![Supports aarch64 Architecture](https://img.shields.io/badge/aarch64-yes-green.svg)\n\u003c/div\u003e\n\n## About\n\nThis repository contains a Home Assistant add-on that packages [Blocky](https://github.com/0xERR0R/blocky), a fast and lightweight DNS proxy and ad-blocker. Blocky provides network-wide ad blocking, privacy protection, and advanced DNS features for your entire network through a single Home Assistant add-on.\n\n### Key Features\n\n- **Network-Wide Ad Blocking** - Block ads, trackers, and malicious domains across all devices\n- **Modern DNS Protocols** - Support for DNS-over-TLS (DoT) and DNS-over-HTTPS (DoH)\n- **Multiple Upstream Resolvers** - Configure multiple DNS providers with intelligent query distribution\n- **Split-DNS / Conditional Routing** - Route specific domains to designated DNS servers\n- **Custom DNS Mappings** - Define local hostname-to-IP mappings without upstream forwarding\n- **Client Groups \u0026 Identification** - Apply different blocking rules per device or client\n- **Query Logging** - Record DNS queries to CSV, MySQL, PostgreSQL, or console\n- **Redis Integration** - Synchronize cache across multiple Blocky instances\n- **Prometheus Metrics** - Built-in monitoring endpoint for observability\n- **HTTP API** - Programmatically control blocking, test queries, and refresh blocklists\n- **Smart Caching** - DNS response caching with prefetching support\n\n## Quick Start\n\nThis add-on can be installed directly from the Home Assistant Add-on Store or by adding this repository manually.\n\n**For complete installation and usage instructions**, see the [Add-on README](./blocky/README.md).\n\n### Requirements\n\n- Home Assistant OS or Home Assistant Supervised\n- Supported architecture: amd64 or aarch64\n\n### Basic Setup\n\n1. Install the add-on\n2. Configure your upstream DNS servers and blocklists\n3. Start the add-on\n4. Point your router or devices to use your Home Assistant IP as the DNS server\n\n## Documentation\n\nThis repository contains documentation for different audiences:\n\n| Document | Audience | Contents |\n|----------|----------|----------|\n| [blocky/README.md](./blocky/README.md) | **Users** | Installation, configuration, usage, troubleshooting |\n| [blocky/DOCS.md](./blocky/DOCS.md) | **Advanced Users** | Complete configuration reference, API documentation, performance tuning |\n| [CLAUDE.md](./CLAUDE.md) | **Developers** | Architecture, development workflow, contribution guidelines |\n\n## Repository Structure\n\n```\n.\n├── CLAUDE.md                 # Developer documentation\n├── blocky/                   # Main add-on directory (stable)\n│   ├── config.yaml           # Add-on configuration schema\n│   ├── DOCS.md               # Technical configuration reference\n│   ├── README.md             # User-facing documentation\n│   ├── Dockerfile            # Multi-architecture container build\n│   ├── rootfs/               # Container filesystem overlay\n│   │   ├── etc/cont-init.d/  # Initialization scripts\n│   │   ├── etc/services.d/   # Service management scripts\n│   │   └── usr/share/tempio/ # Configuration templates\n│   └── translations/         # UI field descriptions\n├── blocky-dev/               # Dev add-on (CI-managed, do not edit)\n├── .github/workflows/        # CI/CD automation\n├── scripts/                  # Build and release utilities\n└── README.md                 # This file\n```\n\n## Configuration\n\nThe add-on supports two configuration modes:\n\n1. **Standard Mode** (Recommended) - Configure through the Home Assistant UI with guided options\n2. **Custom Config Mode** - Use a custom Blocky YAML configuration file for advanced features\n\nSee the [documentation](./blocky/README.md#configuration) for details.\n\n## Development Channel\n\nA separate **Blocky (Dev)** addon is auto-deployed from the latest `main` branch on every push that changes `blocky/`. It lives in the `blocky-dev/` directory.\n\nKey differences from the stable addon:\n- **Local builds** — HA builds the Docker image locally from the Dockerfile (no pre-built GHCR images)\n- **Auto-versioned** — version is set to `dev-\u003ccommit SHA\u003e` on each push\n- **CI-managed** — do not edit `blocky-dev/` manually; changes are overwritten by the `Deploy Dev` workflow\n- **Same ports** — uses the same default ports (53, 4000) as stable; only one addon can run at a time\n\nTo use it, add this repository to your HA instance — both \"Blocky\" and \"Blocky (Dev)\" will appear in the add-on store.\n\n## Contributing\n\nContributions are welcome! Here's how you can help:\n\n### Reporting Issues\n\nIf you encounter problems or have feature requests, please [open an issue](https://github.com/robocopklaus/hassio-addon-blocky/issues) with:\n- A clear description of the issue\n- Steps to reproduce (if applicable)\n- Your Home Assistant version and architecture\n- Relevant logs from the add-on\n\n### Development\n\nFor development setup and guidelines, see [CLAUDE.md](./CLAUDE.md).\n\nThis project uses:\n- **Conventional Commits** for commit messages\n- **Semantic Release** for automated versioning and releases\n- **Multi-architecture Docker builds** for broad platform support\n\n### Testing\n\nBefore submitting a PR:\n1. Test your changes on your Home Assistant instance\n2. Verify the add-on starts successfully\n3. Check that DNS resolution works as expected\n4. Ensure any configuration changes are properly documented\n\n## Credits\n\n- **Upstream Project**: [Blocky](https://github.com/0xERR0R/blocky) by [@0xERR0R](https://github.com/0xERR0R)\n- **Home Assistant Community**: For the excellent add-on ecosystem and tools\n- **Contributors**: Everyone who has helped improve this add-on\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\nThe upstream Blocky project is licensed under the Apache License 2.0.\n\n## Support\n\n- **Add-on Issues**: [GitHub Issues](https://github.com/robocopklaus/hassio-addon-blocky/issues)\n- **Blocky Documentation**: [Official Blocky Docs](https://0xerr0r.github.io/blocky/)\n- **Home Assistant Community**: [Community Forum](https://community.home-assistant.io/)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  Made with ❤️ for the Home Assistant community\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobocopklaus%2Fhassio-addon-blocky","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frobocopklaus%2Fhassio-addon-blocky","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobocopklaus%2Fhassio-addon-blocky/lists"}