{
  "aid": "0xerr0r.github.io:main-1.0",
  "name": "blocky API",
  "type": "Index",
  "description": "# Blocky\nBlocky is a DNS proxy and ad-blocker for the local network written in Go with following features:\n## Features\n- **Blocking** - Blocking of DNS queries with external lists (Ad-block, malware) and allowlisting\n\n  - Definition of allow/denylists per client group (Kids, Smart home devices, etc.)\n  - Periodical reload of external allow/denylists\n  - Regex support\n  - Blocking of request domain, response CNAME (deep CNAME inspection) and response IP addresses (against IP lists)\n\n- **Advanced DNS configuration** - not just an ad-blocker\n\n  - Custom DNS resolution for certain domain names\n  - Conditional forwarding to external DNS server\n  - Upstream resolvers can be defined per client group\n\n- **Performance** - Improves speed and performance in your network\n\n  - Customizable caching of DNS answers for queries -> improves DNS resolution speed and reduces amount of external DNS\n    queries\n  - Prefetching and caching of often used queries\n  - Using multiple external resolver simultaneously\n  - Low memory footprint\n\n- **Various Protocols** - Supports modern DNS protocols\n\n  - DNS over UDP and TCP\n  - DNS over HTTPS (aka DoH)\n  - DNS over TLS (aka DoT)\n\n- **Security and Privacy** - Secure communication\n\n  - Supports modern DNS extensions: DNSSEC, eDNS, ...\n  - Free configurable blocking lists - no hidden filtering etc.\n  - Provides DoH Endpoint\n  - Uses random upstream resolvers from the configuration - increases your privacy through the distribution of your DNS\n    traffic over multiple provider\n  - Blocky does **NOT** collect any user data, telemetry, statistics etc.\n\n- **Integration** - various integration\n\n  - [Prometheus](https://prometheus.io/) metrics\n  - Prepared [Grafana](https://grafana.com/) dashboards (Prometheus and database)\n  - Logging of DNS queries per day / per client in CSV format or MySQL/MariaDB/PostgreSQL/Timescale database - easy to\n    analyze\n  - Various REST API endpoints\n  - CLI tool\n\n- **Simple configuration** - single or multiple configuration files in YAML format\n\n  - Simple to maintain\n  - Simple to backup\n\n- **Simple installation/configuration** - blocky was designed for simple installation\n\n  - Stateless (no database, no temporary files)\n  - Docker image with Multi-arch support\n  - Single binary\n  - Supports x86-64 and ARM architectures -> runs fine on Raspberry PI\n  - Community supported Helm chart for k8s deployment\n\n## Quick start\nYou can jump to [Installation](https://0xerr0r.github.io/blocky/installation/) chapter in the documentation.\n## Full documentation\nYou can find full documentation and configuration examples at: [https://0xERR0R.github.io/blocky/](https://0xERR0R.github.io/blocky/)",
  "url": "https://raw.githubusercontent.com/jentic/jentic-public-apis/refs/heads/main/apis/openapi/0xerr0r.github.io/main/1.0/apis.json",
  "tags": [
    "0xerr0r.github.io",
    "main"
  ],
  "created": "2026-03-28",
  "modified": "2026-03-28",
  "specificationVersion": "0.19",
  "access": "3rd-Party",
  "maintainers": [
    {
      "FN": "Jentic",
      "X-github": "jentic",
      "url": "https://github.com/jentic"
    }
  ],
  "apis": [
    {
      "aid": "0xerr0r.github.io:main-1.0",
      "name": "blocky API",
      "description": "# Blocky\nBlocky is a DNS proxy and ad-blocker for the local network written in Go with following features:\n## Features\n- **Blocking** - Blocking of DNS queries with external lists (Ad-block, malware) and allowlisting\n\n  - Definition of allow/denylists per client group (Kids, Smart home devices, etc.)\n  - Periodical reload of external allow/denylists\n  - Regex support\n  - Blocking of request domain, response CNAME (deep CNAME inspection) and response IP addresses (against IP lists)\n\n- **Advanced DNS configuration** - not just an ad-blocker\n\n  - Custom DNS resolution for certain domain names\n  - Conditional forwarding to external DNS server\n  - Upstream resolvers can be defined per client group\n\n- **Performance** - Improves speed and performance in your network\n\n  - Customizable caching of DNS answers for queries -> improves DNS resolution speed and reduces amount of external DNS\n    queries\n  - Prefetching and caching of often used queries\n  - Using multiple external resolver simultaneously\n  - Low memory footprint\n\n- **Various Protocols** - Supports modern DNS protocols\n\n  - DNS over UDP and TCP\n  - DNS over HTTPS (aka DoH)\n  - DNS over TLS (aka DoT)\n\n- **Security and Privacy** - Secure communication\n\n  - Supports modern DNS extensions: DNSSEC, eDNS, ...\n  - Free configurable blocking lists - no hidden filtering etc.\n  - Provides DoH Endpoint\n  - Uses random upstream resolvers from the configuration - increases your privacy through the distribution of your DNS\n    traffic over multiple provider\n  - Blocky does **NOT** collect any user data, telemetry, statistics etc.\n\n- **Integration** - various integration\n\n  - [Prometheus](https://prometheus.io/) metrics\n  - Prepared [Grafana](https://grafana.com/) dashboards (Prometheus and database)\n  - Logging of DNS queries per day / per client in CSV format or MySQL/MariaDB/PostgreSQL/Timescale database - easy to\n    analyze\n  - Various REST API endpoints\n  - CLI tool\n\n- **Simple configuration** - single or multiple configuration files in YAML format\n\n  - Simple to maintain\n  - Simple to backup\n\n- **Simple installation/configuration** - blocky was designed for simple installation\n\n  - Stateless (no database, no temporary files)\n  - Docker image with Multi-arch support\n  - Single binary\n  - Supports x86-64 and ARM architectures -> runs fine on Raspberry PI\n  - Community supported Helm chart for k8s deployment\n\n## Quick start\nYou can jump to [Installation](https://0xerr0r.github.io/blocky/installation/) chapter in the documentation.\n## Full documentation\nYou can find full documentation and configuration examples at: [https://0xERR0R.github.io/blocky/](https://0xERR0R.github.io/blocky/)",
      "image": "",
      "baseURL": "/api",
      "humanURL": "https://github.com/jentic/jentic-public-apis/tree/main/apis/openapi/0xerr0r.github.io/main/1.0",
      "version": "1.0",
      "tags": [
        "0xerr0r.github.io",
        "main"
      ],
      "properties": [
        {
          "type": "OpenAPI",
          "name": "OpenAPI definition",
          "url": "https://raw.githubusercontent.com/jentic/jentic-public-apis/refs/heads/main/apis/openapi/0xerr0r.github.io/main/1.0/openapi.json",
          "mediaType": "application/openapi+json"
        },
        {
          "type": "GitHubRepo",
          "url": "https://github.com/jentic/jentic-public-apis/tree/main/apis/openapi/0xerr0r.github.io/main/1.0"
        }
      ],
      "contact": [
        {
          "FN": "blocky@github",
          "url": "https://github.com/0xERR0R/blocky"
        }
      ]
    }
  ]
}