Pi-hole

DNSpi-hole

Network DNS sinkhole that forwards queries upstream and answers blocklisted names itself.

Provider: default
Kind: DNS
Category: Edge
Official docs: https://docs.pi-hole.net/

Properties · 3 set by this component

property	type	values	required	kind default	this component
anycast	boolean	—	no	false	▸ false
blocklistFiltering · component property	boolean	—	no	true	inherited
dhcpServer · component property	boolean	—	no	false	inherited
dnssecValidation · component property	boolean	—	no	false	inherited
geoRouting	boolean	—	no	false	▸ false
healthChecked	boolean	—	no	false	inherited
managed	boolean	—	no	true	▸ false
redundantProviders	boolean	—	no	false	inherited
ttlSeconds	integer	—	no	—	inherited

Rules that apply · 1

Every rule whose selector covers this component's kind or its category. Whether a rule fires depends on the design: its properties, its edges and its groups.

Shared dependency without redundancyerror

shared-dependency-without-redundancy

The design requires redundant discovery, but this DNS or coordination service, which everything depends on, runs on a single provider or a single replica. Its failure is the whole system's failure.

— all of these hold:
— the design requirement `availability.discoveryRedundant` is true
— any of these hold:
— the node's `redundantProviders` is false
— the node's `replicated` is false

Use it in a design

nodes:
  - { id: "pi-hole", component: "pi-hole" }

Other DNS products · 33

Alibaba Cloud DNSalibaba-dnsalibabaclouddns Alibaba Cloud Domain Namesalibaba-domainsalibabaclouddns Alibaba Cloud DNS PrivateZonealibaba-private-zonealibabaclouddns Amazon Application Recovery Controller (ARC)aws-application-recovery-controllerawsdns Amazon Route 53 Global Resolveraws-route53-global-resolverawsdns Amazon Route 53 Resolver endpointaws-route53-resolverawsdns Amazon Route 53route53awsdns Azure DNSazure-dnsazuredns Azure DNS Private Resolverazure-dns-private-resolverazuredns Azure Private DNSazure-private-dnsazuredns Azure Traffic Managerazure-traffic-managerazuredns Cloudflare DNScloudflare-dnscloudflaredns Cloudflare Internal DNScloudflare-internal-dnscloudflaredns Cloudflare Registrarcloudflare-registrarcloudflaredns Cloudflare Secondary DNScloudflare-secondary-dnscloudflaredns BIND 9binddns CoreDNScorednsdns Generic DNSdnsdns DNSdns-resolverdns dnsmasqdnsmasqdns ExternalDNSexternal-dnsdns Knot DNSknot-dnsdns IBM NS1 Connectns1dns PowerDNS Authoritative Serverpowerdnsdns Unboundunbounddns DigitalOcean DNSdigitalocean-dnsdigitaloceandns Google Cloud DNSgoogle-cloud-dnsgcpdns Cloud Domainsgoogle-cloud-domainsgcpdns IBM Cloud DNS Servicesibm-dns-servicesibmdns DNS Private Zoneoci-dns-private-zoneocidns DNS Public Zoneoci-dns-zoneocidns Traffic Management Steering Policyoci-traffic-managementocidns OpenStack Designateopenstack-designateopenstackdns

Source

1# yaml-language-server: $schema=../../schema/component.schema.json
2# Pi-hole: DNS sinkhole for a local network. It forwards queries upstream through its embedded
3# FTLDNS resolver and answers blocklisted names itself. Per the Pi-hole documentation the built-in
4# DHCP server and DNSSEC validation are both off until switched on in settings.
5schemaVersion: "1"
6type: "component"
7id: "pi-hole"
8kind: "dns"
9provider: "default"
10docs: "https://docs.pi-hole.net/"
11defaults:
12  managed: false
13  anycast: false
14  geoRouting: false
15properties:
16  blocklistFiltering:
17    type: "boolean"
18    default: true
19  dnssecValidation:
20    type: "boolean"
21    default: false
22  dhcpServer:
23    type: "boolean"
24    default: false

The same page as markdown, for an agent: /catalogue/components/pi-hole.md