Skip to content
Pi-hole icon
v2.2.2App: v2026.10.0Pinned DigestS3 Backup Ready

Production Helm chart • Apache-2.0 • Zero-Root • Verified on Kubernetes v1.33-v1.36+

Pi-hole DNS Sinkhole

A Helm chart for deploying Pi-hole on Kubernetes using the official pihole/pihole container image.

Installation

HTTPS Repository

helm repo add helmforge https://repo.helmforge.dev
helm repo update
helm install pihole helmforge/pihole

OCI Registry

helm install pihole oci://ghcr.io/helmforgedev/helm/pihole

Quick Start

helm install pihole oci://ghcr.io/helmforgedev/helm/pihole \
  --set admin.password=changeme \
  --set serviceDns.loadBalancerIP=192.168.1.53

Features

  • Network-Wide Ad Blocking — DNS-level filtering for all devices on the network
  • Custom DNS Records — Local A records, CNAME records, and dnsmasq configuration
  • Unbound Sidecar — Optional recursive DNS resolver eliminating third-party DNS dependency
  • Pi-hole v6+ Support — Uses FTLCONF_ environment variables for modern configuration
  • Prometheus Metrics — pihole-exporter sidecar with ServiceMonitor support
  • Ingress Support — Configurable ingress with TLS for the web admin interface
  • DHCP Support — Optional DHCP server with hostNetwork mode
  • DNSSEC Validation — Optional DNS Security Extensions
  • Configurable Listeners — DNS and web ports configure Pi-hole FTL itself
  • Immutable Images — All workload and backup images are pinned by digest
  • Ingress Policy — NetworkPolicy limits inbound traffic to declared ports

Security Scan: pihole

Every PR runs Kubescape against the rendered default manifests using the MITRE, NSA, and SOC2 frameworks. The authoritative score is posted on the PR. The chart drops all capabilities before adding only the official image's required runtime set, disables privilege escalation and API token mounting, uses runtime-default seccomp, pins images by digest, and creates an ingress NetworkPolicy. Root bootstrap and writable Pi-hole configuration remain documented upstream constraints.

Framework Score
MITRE + NSA + SOC2 90.90909%

Configuration

Minimal (Simple Setup)

admin:
  password: "change-me"

serviceDns:
  type: LoadBalancer
  loadBalancerIP: "192.168.1.53"

Production (Full Setup)

pihole:
  timezone: America/Sao_Paulo
  dnssec: true

admin:
  existingSecret: pihole-admin
  existingSecretKey: password

unbound:
  enabled: true
  resources:
    requests:
      cpu: 50m
      memory: 64Mi
    limits:
      cpu: 200m
      memory: 128Mi

dns:
  customRecords:
    - "192.168.1.1 router.home"
    - "192.168.1.10 nas.home"
  cnameRecords:
    - "cname=media.home,nas.home"

persistence:
  enabled: true
  size: 2Gi

resources:
  requests:
    cpu: 100m
    memory: 128Mi
  limits:
    cpu: 500m
    memory: 512Mi

serviceDns:
  type: LoadBalancer
  loadBalancerIP: "192.168.1.53"
  externalTrafficPolicy: Local

ingress:
  enabled: true
  ingressClassName: traefik
  annotations:
    cert-manager.io/cluster-issuer: letsencrypt-prod
  hosts:
    - host: pihole.home
      paths:
        - path: /
          pathType: Prefix
  tls:
    - secretName: pihole-tls
      hosts:
        - pihole.home

metrics:
  enabled: true
  serviceMonitor:
    enabled: true
    labels:
      release: prometheus

Parameters

Pi-hole

Official Schema

Values & Configuration Reference

All schema parameters, types, defaults, and allowed values are extracted directly from the chart repository. Filter and search them in the interactive reference below or customize in Values Studio.

View Values Schema

Image tags and digests form a pair. When overriding any image tag, also set the matching digest to the digest published for that exact tag; Kubernetes resolves the digest as the deployed image identity.

Admin

Official Schema

Values & Configuration Reference

All schema parameters, types, defaults, and allowed values are extracted directly from the chart repository. Filter and search them in the interactive reference below or customize in Values Studio.

View Values Schema

DNS Records

Official Schema

Values & Configuration Reference

All schema parameters, types, defaults, and allowed values are extracted directly from the chart repository. Filter and search them in the interactive reference below or customize in Values Studio.

View Values Schema

Gravity

Official Schema

Values & Configuration Reference

All schema parameters, types, defaults, and allowed values are extracted directly from the chart repository. Filter and search them in the interactive reference below or customize in Values Studio.

View Values Schema

Persistence

Official Schema

Values & Configuration Reference

All schema parameters, types, defaults, and allowed values are extracted directly from the chart repository. Filter and search them in the interactive reference below or customize in Values Studio.

View Values Schema

Services

Official Schema

Values & Configuration Reference

All schema parameters, types, defaults, and allowed values are extracted directly from the chart repository. Filter and search them in the interactive reference below or customize in Values Studio.

View Values Schema

serviceDns.port and serviceWeb.port are client-facing Service ports. containerPorts.dns changes the Pi-hole FTL DNS listener. containerPorts.http is the primary unencrypted web listener targeted by the Web Service, HTTP probes, and metrics exporter. For multiple IPv4, IPv6, HTTP, or HTTPS listeners, set pihole.webserverPort to the complete FTL value and include containerPorts.http as a directly served HTTP listener bound to all pod interfaces. Do not add r or s to that primary listener or bind it to a specific address; Service probes and the metrics exporter require direct HTTP. Redirect, TLS, and address-specific listeners may be added separately. For example:

containerPorts:
  http: 9090
pihole:
  webserverPort: "9090o,[::]:9090o,9091os,[::]:9091os"

The chart Web Service and default NetworkPolicy expose only containerPorts.http; additional FTL listeners such as HTTPS 9091 are not routed through that Service. With hostNetwork, reach them directly through the node and enforce access with the node firewall. For ordinary pod networking, terminate TLS at an Ingress or Gateway that targets the primary HTTP listener.

DHCP remains on protocol-defined UDP port 67.

Security and Resources

Official Schema

Values & Configuration Reference

All schema parameters, types, defaults, and allowed values are extracted directly from the chart repository. Filter and search them in the interactive reference below or customize in Values Studio.

View Values Schema

NetworkPolicy enforcement for dhcp.hostNetwork: true depends on the cluster network plugin. Verify host-network policy behavior and use node-level controls when the Pi-hole listeners must be restricted.

Ingress

Official Schema

Values & Configuration Reference

All schema parameters, types, defaults, and allowed values are extracted directly from the chart repository. Filter and search them in the interactive reference below or customize in Values Studio.

View Values Schema

Metrics

Official Schema

Values & Configuration Reference

All schema parameters, types, defaults, and allowed values are extracted directly from the chart repository. Filter and search them in the interactive reference below or customize in Values Studio.

View Values Schema

Backup

Official Schema

Values & Configuration Reference

All schema parameters, types, defaults, and allowed values are extracted directly from the chart repository. Filter and search them in the interactive reference below or customize in Values Studio.

View Values Schema

Unbound

Official Schema

Values & Configuration Reference

All schema parameters, types, defaults, and allowed values are extracted directly from the chart repository. Filter and search them in the interactive reference below or customize in Values Studio.

View Values Schema

DHCP

Official Schema

Values & Configuration Reference

All schema parameters, types, defaults, and allowed values are extracted directly from the chart repository. Filter and search them in the interactive reference below or customize in Values Studio.

View Values Schema

Scheduling

Official Schema

Values & Configuration Reference

All schema parameters, types, defaults, and allowed values are extracted directly from the chart repository. Filter and search them in the interactive reference below or customize in Values Studio.

View Values Schema

Resources Generated

Resource Condition Description
Deployment Always Pi-hole server (single replica, Recreate strategy)
Service (DNS) Always DNS ports TCP/UDP 53 (LoadBalancer by default)
Service (Web) Always Web admin port 80 (ClusterIP by default)
PersistentVolumeClaim persistence.enabled Pi-hole data volume
Secret No admin.existingSecret Admin password
ConfigMap Custom DNS/dnsmasq config DNS records and dnsmasq config
Ingress ingress.enabled Web admin ingress
ServiceAccount serviceAccount.create Dedicated SA
ServiceMonitor metrics.serviceMonitor.enabled Prometheus scrape config

Examples

  • Simple — minimal deployment with fixed DNS IP
  • Production — Unbound, ingress, metrics, custom DNS
  • Custom DNS — local DNS records and conditional forwarding

Architecture Guides

Upgrade Notes

Upgrading to 2026.10.0

Pi-hole 2026.10.0 includes FTL 6.8, Web 6.6.1, Core 6.5, and fixes for 17 published security advisories. The Docker release also prevents Secret-backed web passwords from appearing in shell traces and makes FTL and release downloads fail closed. Back up the persistent data and verify DNS, admin login, gravity updates, and any enabled Unbound or DHCP workflow after rollout.

Chart 2.2.0 changed securityContext.capabilities to drop all capabilities before adding the complete set required by the official image. Helm replaces custom arrays during an upgrade, so a securityContext.capabilities.add override copied from chart 2.1.x removes the new required defaults and prevents Pi-hole from starting. Inspect stored overrides with helm get values <release> -n <namespace>, remove the old capability override, then upgrade with --reset-values and pass the other intended overrides again. Do not use --reuse-values or --reset-then-reuse-values for this migration because both retain the stored capability override. When dhcp.enabled is true, the chart now adds NET_ADMIN automatically.

Upstream release notes: Pi-hole 2026.10.0.

Upgrading to 2026.09.0

Pi-hole 2026.09.0 includes FTL 6.7.1 fixes for remote code execution, arbitrary file reads, a stack overflow and configuration-validation bypasses. The API and web interface can no longer change misc.dnsmasq_lines or webserver.advancedOpts. Configure them in pihole.toml, through environment variables, or with pihole-FTL --config. No chart-specific migration is required, but back up /etc/pihole and /etc/dnsmasq.d before rollout.

Connection

After installation, configure your network to use Pi-hole as DNS:

# Get DNS LoadBalancer IP
kubectl get svc <release>-pihole-dns -o jsonpath='{.status.loadBalancer.ingress[0].ip}'

# Get admin password
kubectl get secret <release>-pihole -o jsonpath='{.data.password}' | base64 -d

# Access web admin
kubectl port-forward svc/<release>-pihole-web 8080:80
# Then visit http://localhost:8080/admin

Troubleshooting

For DNS, listener, gravity, Unbound, DHCP, backup, and recovery diagnostics, see the operations guide. Start with pod events and all container logs, then verify the DNS Service EndpointSlice and both UDP and TCP queries before changing the chart configuration.

Non-Goals

This chart intentionally does not support:

  • Multi-instance clustering — Pi-hole does not support clustering natively
  • Gravity Sync — Use a separate tool or manual sync for multi-instance setups
  • Built-in VPN — Use a dedicated VPN solution (WireGuard, etc.)

System Architecture

DESIGN.md Synced

Verified architecture contract rendered dynamically from GitHub DESIGN.md

flowchart LR
  dnsClients[DNS clients] --> dnsService[DNS Service]
  webClients[Web clients] --> webService[Web Service or Ingress]
  dnsService --> pihole[Pi-hole FTL]
  webService --> pihole
  pihole --> upstream[Upstream DNS or Unbound]
  pihole --> data[(Persistent configuration)]
Official Contractvalues.schema.json

Pi-hole Values Schema Reference

Official schema parameters, default values, and types extracted directly from the chart repository.

204 parametersValues Studio

Global(1)

ParameterTypeDefaultDescription
globalobject-Global settings shared by the chart.

Name Override(1)

ParameterTypeDefaultDescription
nameOverridestring""Override the chart name used in resource names

Fullname Override(1)

ParameterTypeDefaultDescription
fullnameOverridestring""Override the full release name used in resource names

Common Labels(1)

ParameterTypeDefaultDescription
commonLabelsobject-Labels added to every resource created by this chart

Common Annotations(1)

ParameterTypeDefaultDescription
commonAnnotationsobject-Annotations added to every chart-managed resource (not pod templates)

Image(4)

ParameterTypeDefaultDescription
image.repositorystringdocker.io/pihole/piholeContainer image repository
image.tagstring2026.10.0Container image tag
image.digeststring-Chart configuration parameter
image.pullPolicystringIfNotPresentImage pull policy
Allowed:AlwaysIfNotPresentNever

Image Pull Secrets(1)

ParameterTypeDefaultDescription
imagePullSecretsarray-Image pull secrets for private registries

Container Ports(2)

ParameterTypeDefaultDescription
containerPorts.dnsinteger53Chart configuration parameter
containerPorts.httpinteger80Chart configuration parameter

Pihole(14)

ParameterTypeDefaultDescription
pihole.timezonestringUTCTimezone for logs and scheduled tasks
pihole.upstreamDnsstring8.8.8.8;8.8.4.4Upstream DNS servers (semicolon-delimited). When unbound sidecar is enabled, this is overridden to 127.0.0.1#5335.
pihole.listeningModestringALLDNS listening mode
Allowed:LOCALALLSINGLEBIND
pihole.webserverPortstring""Full Pi-hole FTL webserver.port value. Empty derives from containerPorts.http. The primary port must serve HTTP directly on all pod interfaces.
pihole.dnssecbooleanfalseEnable DNSSEC validation
pihole.ftl.cacheSizeinteger10000DNS cache size
pihole.ftl.privacyLevelinteger0Privacy level (0-3)
pihole.ftl.cnameInspectionbooleantrueBlock CNAME-cloaked trackers
pihole.ftl.rateLimitinteger1000Rate limiting query count per client; set to 0 to disable rate limiting
pihole.ftl.rateLimitIntervalinteger60Rate limiting interval in seconds
pihole.ftl.blockAAAAbooleanfalseBlock AAAA queries on A-only networks
pihole.ftl.queryLoggingbooleantrueQuery logging
pihole.ftl.useDatabasebooleantrueUse database for queries (required for long-term stats)
pihole.extraEnvarray-Additional environment variables for the Pi-hole container

Admin(3)

ParameterTypeDefaultDescription
admin.passwordstring""Web admin password (auto-generated if empty and no existingSecret)
admin.existingSecretstring""Use an existing secret for the admin password
admin.existingSecretKeystringpasswordKey in the existing secret that contains the admin password

Dns(18)

ParameterTypeDefaultDescription
dns.presetstringnoneBlocklist preset
Allowed:nonebasicbalancedaggressivegaming-friendly
dns.adlistsarray-Custom blocklist URLs (added to preset)
dns.whitelistPresets.microsoftbooleanfalseWhitelist Microsoft services
dns.whitelistPresets.applebooleanfalseWhitelist Apple services
dns.whitelistPresets.googlebooleanfalseWhitelist Google services
dns.whitelistPresets.gamingbooleanfalseWhitelist gaming platforms
dns.whitelistPresets.smartHomebooleanfalseWhitelist smart home devices
dns.whitelistarray-Manual whitelisted domains (added to presets)
dns.blacklistarray-Blacklisted domains (exact matches)
dns.regexarray-Regex filters for blocking (advanced)
dns.conditionalForwarding.enabledbooleanfalseEnable conditional forwarding
dns.conditionalForwarding.domainstring""Local network domain
dns.conditionalForwarding.networkstring""Local network CIDR
dns.conditionalForwarding.routerstring""Router/DNS server IP for reverse lookups
dns.conditionalForwarding.customRulesarray-Additional conditional forwarding rules
dns.customRecordsarray-Custom local DNS A records (each entry: "IP HOSTNAME")
dns.cnameRecordsarray-Custom CNAME records (dnsmasq format)
dns.customDnsmasqarray-Custom dnsmasq configuration lines

Persistence(6)

ParameterTypeDefaultDescription
persistence.enabledbooleantrueEnable persistent storage for /etc/pihole
persistence.storageClassstring""Storage class (leave empty for cluster default)
persistence.accessModestringReadWriteOnceAccess mode for the PVC
persistence.sizestring1GiSize of the persistent volume
persistence.existingClaimstring""Use an existing PVC instead of creating one
persistence.annotationsobject-Annotations for the PVC

Gravity(10)

ParameterTypeDefaultDescription
gravity.enabledbooleantrueEnable automated gravity database initialization
gravity.updateOnInitbooleantrueRun pihole -g after populating database
gravity.resources.requests.cpustringnumber-Chart configuration parameter
gravity.resources.requests.memorystringnumber-Chart configuration parameter
gravity.resources.limits.cpustringnumber-Chart configuration parameter
gravity.resources.limits.memorystringnumber-Chart configuration parameter
gravity.updateResources.requests.cpustringnumber-Chart configuration parameter
gravity.updateResources.requests.memorystringnumber-Chart configuration parameter
gravity.updateResources.limits.cpustringnumber-Chart configuration parameter
gravity.updateResources.limits.memorystringnumber-Chart configuration parameter

Backup(33)

ParameterTypeDefaultDescription
backup.enabledbooleanfalseEnable automated backups to S3
backup.schedulestring0 3 * * *Backup schedule (cron format)
backup.backoffLimitinteger1Chart configuration parameter
backup.successfulJobsHistoryLimitinteger3Chart configuration parameter
backup.failedJobsHistoryLimitinteger1Chart configuration parameter
backup.concurrencyPolicystringForbidChart configuration parameter
Allowed:ForbidAllowReplace
backup.include.gravitybooleantrueChart configuration parameter
backup.include.customDnsbooleantrueChart configuration parameter
backup.include.dnsmasqbooleantrueChart configuration parameter
backup.images.utility.repositorystring-Chart configuration parameter
backup.images.utility.tagstring-Chart configuration parameter
backup.images.utility.digeststring-Chart configuration parameter
backup.images.utility.pullPolicystring-Chart configuration parameter
Allowed:AlwaysIfNotPresentNever
backup.images.uploader.repositorystring-Chart configuration parameter
backup.images.uploader.tagstring-Chart configuration parameter
backup.images.uploader.digeststring-Chart configuration parameter
backup.images.uploader.pullPolicystring-Chart configuration parameter
Allowed:AlwaysIfNotPresentNever
backup.resources.requests.cpustringnumber-Chart configuration parameter
backup.resources.requests.memorystringnumber-Chart configuration parameter
backup.resources.limits.cpustringnumber-Chart configuration parameter
backup.resources.limits.memorystringnumber-Chart configuration parameter
backup.serviceAccount.createbooleantrueChart configuration parameter
backup.serviceAccount.namestring""Chart configuration parameter
backup.serviceAccount.annotationsobject-Chart configuration parameter
backup.serviceAccount.automountServiceAccountTokenbooleanfalseChart configuration parameter
backup.s3.endpointstring-Chart configuration parameter
backup.s3.bucketstring-Chart configuration parameter
backup.s3.prefixstringpiholeChart configuration parameter
backup.s3.existingSecretstring-Chart configuration parameter
backup.s3.accessKeystring-Chart configuration parameter
backup.s3.secretKeystring-Chart configuration parameter
backup.s3.regionstring""Chart configuration parameter
backup.s3.credentialsFromPodIdentitybooleanfalseChart configuration parameter

Resources(4)

ParameterTypeDefaultDescription
resources.requests.cpustringnumber-Chart configuration parameter
resources.requests.memorystringnumber-Chart configuration parameter
resources.limits.cpustringnumber-Chart configuration parameter
resources.limits.memorystringnumber-Chart configuration parameter

Host Network(1)

ParameterTypeDefaultDescription
hostNetworkbooleanfalseUse the host network for the main Pi-hole pod

Dns Policy(1)

ParameterTypeDefaultDescription
dnsPolicystring""Pod DNS policy. Defaults to ClusterFirstWithHostNet when hostNetwork is enabled.
Allowed:ClusterFirstWithHostNetClusterFirstDefaultNone

Pod Security(1)

ParameterTypeDefaultDescription
podSecurityContext.seccompProfile.typestring-Chart configuration parameter
Allowed:RuntimeDefaultLocalhostUnconfined

Container Security(3)

ParameterTypeDefaultDescription
securityContext.allowPrivilegeEscalationboolean-Chart configuration parameter
securityContext.capabilities.addarray-Chart configuration parameter
securityContext.capabilities.droparray-Chart configuration parameter

Startup Probe(5)

ParameterTypeDefaultDescription
startupProbe.enabledbooleantrueEnable startup probe
startupProbe.initialDelaySecondsinteger-Chart configuration parameter
startupProbe.periodSecondsinteger-Chart configuration parameter
startupProbe.timeoutSecondsinteger-Chart configuration parameter
startupProbe.failureThresholdinteger-Chart configuration parameter

Liveness Probe(5)

ParameterTypeDefaultDescription
livenessProbe.enabledbooleantrueEnable liveness probe
livenessProbe.initialDelaySecondsinteger-Chart configuration parameter
livenessProbe.periodSecondsinteger-Chart configuration parameter
livenessProbe.timeoutSecondsinteger-Chart configuration parameter
livenessProbe.failureThresholdinteger-Chart configuration parameter

Readiness Probe(5)

ParameterTypeDefaultDescription
readinessProbe.enabledbooleantrueEnable readiness probe
readinessProbe.initialDelaySecondsinteger-Chart configuration parameter
readinessProbe.periodSecondsinteger-Chart configuration parameter
readinessProbe.timeoutSecondsinteger-Chart configuration parameter
readinessProbe.failureThresholdinteger-Chart configuration parameter

Service Dns(7)

ParameterTypeDefaultDescription
serviceDns.typestringLoadBalancerService type for DNS
Allowed:ClusterIPNodePortLoadBalancer
serviceDns.portinteger53DNS port
serviceDns.annotationsobject-Annotations for the DNS service
serviceDns.externalTrafficPolicystring-External traffic policy (set to Local for client IP preservation)
serviceDns.loadBalancerIPstring-Load balancer IP (set a fixed IP for DNS stability)
serviceDns.ipFamilyPolicystringnull-Dual-stack ipFamilyPolicy (GR-058)
Allowed:nullSingleStackPreferDualStackRequireDualStack
serviceDns.ipFamiliesarray-Dual-stack ipFamilies (GR-058)

Service Web(5)

ParameterTypeDefaultDescription
serviceWeb.typestringClusterIPService type for web admin
Allowed:ClusterIPNodePortLoadBalancer
serviceWeb.portinteger80Web admin HTTP port
serviceWeb.annotationsobject-Annotations for the web service
serviceWeb.ipFamilyPolicystringnull-Dual-stack ipFamilyPolicy (GR-058)
Allowed:nullSingleStackPreferDualStackRequireDualStack
serviceWeb.ipFamiliesarray-Dual-stack ipFamilies (GR-058)

Ingress(5)

ParameterTypeDefaultDescription
ingress.enabledbooleanfalseEnable ingress for the web admin interface
ingress.ingressClassNamestring""Ingress class name
ingress.annotationsobject-Ingress annotations
ingress.hostsarray-Ingress hosts
ingress.tlsarray-Ingress TLS configuration

Service Account(4)

ParameterTypeDefaultDescription
serviceAccount.createbooleanfalseCreate a dedicated ServiceAccount
serviceAccount.namestring""Name override (auto-generated if empty)
serviceAccount.annotationsobject-Annotations for the ServiceAccount
serviceAccount.automountServiceAccountTokenbooleanfalseMount the Kubernetes API token into the Pi-hole pod

Metrics & Observability(15)

ParameterTypeDefaultDescription
metrics.enabledbooleanfalseEnable Prometheus metrics via pihole-exporter sidecar
metrics.image.repositorystringdocker.io/ekofr/pihole-exporterpihole-exporter image repository
metrics.image.tagstringv1.2.0pihole-exporter image tag
metrics.image.digeststring-Chart configuration parameter
metrics.image.pullPolicystringIfNotPresentpihole-exporter pull policy
Allowed:AlwaysIfNotPresentNever
metrics.portinteger9617Port for the Prometheus metrics endpoint
metrics.resources.requests.cpustringnumber-Chart configuration parameter
metrics.resources.requests.memorystringnumber-Chart configuration parameter
metrics.resources.limits.cpustringnumber-Chart configuration parameter
metrics.resources.limits.memorystringnumber-Chart configuration parameter
metrics.securityContext.allowPrivilegeEscalationboolean-Chart configuration parameter
metrics.securityContext.capabilities.droparray-Chart configuration parameter
metrics.serviceMonitor.enabledbooleanfalseCreate a ServiceMonitor resource
metrics.serviceMonitor.intervalstring30sScrape interval
metrics.serviceMonitor.labelsobject-Additional labels for the ServiceMonitor

Unbound(15)

ParameterTypeDefaultDescription
unbound.enabledbooleanfalseEnable Unbound sidecar for recursive DNS resolution
unbound.image.repositorystringdocker.io/mvance/unboundUnbound image repository
unbound.image.tagstring1.22.0Unbound image tag
unbound.image.digeststring-Chart configuration parameter
unbound.image.pullPolicystringIfNotPresentUnbound pull policy
Allowed:AlwaysIfNotPresentNever
unbound.portinteger5335Unbound listening port inside the pod
unbound.configstring""Full unbound.conf override. When empty, a sensible default binding 127.0.0.1 at unbound.port is rendered.
unbound.extraConfigstring""Extra unbound directives appended inside the default server: section. Ignored when unbound.config is set.
unbound.resources.requests.cpustringnumber-Chart configuration parameter
unbound.resources.requests.memorystringnumber-Chart configuration parameter
unbound.resources.limits.cpustringnumber-Chart configuration parameter
unbound.resources.limits.memorystringnumber-Chart configuration parameter
unbound.securityContext.allowPrivilegeEscalationboolean-Chart configuration parameter
unbound.securityContext.capabilities.addarray-Chart configuration parameter
unbound.securityContext.capabilities.droparray-Chart configuration parameter

Network Policy(2)

ParameterTypeDefaultDescription
networkPolicy.enabledbooleantrueChart configuration parameter
networkPolicy.ingressFromarray-Chart configuration parameter

Dhcp(6)

ParameterTypeDefaultDescription
dhcp.enabledbooleanfalseEnable DHCP server
dhcp.hostNetworkbooleanfalseUse host network for DHCP broadcasts
dhcp.startstring-First IPv4 address in the DHCP lease range
dhcp.endstring-Last IPv4 address in the DHCP lease range
dhcp.routerstring-Router IPv4 address advertised to DHCP clients
dhcp.leaseTimestring-DHCP lease time

Node Selector(1)

ParameterTypeDefaultDescription
nodeSelectorobject-Node selector for pod scheduling

Tolerations(1)

ParameterTypeDefaultDescription
tolerationsarray-Tolerations for pod scheduling

Affinity(1)

ParameterTypeDefaultDescription
affinityobject-Affinity rules for pod scheduling

Topology Spread Constraints(1)

ParameterTypeDefaultDescription
topologySpreadConstraintsarray-Topology spread constraints

Priority Class Name(1)

ParameterTypeDefaultDescription
priorityClassNamestring""Priority class name

Termination Grace Period Seconds(1)

ParameterTypeDefaultDescription
terminationGracePeriodSecondsinteger30Grace period for shutdown (seconds)

Pod Labels(1)

ParameterTypeDefaultDescription
podLabelsobject-Additional labels for the pod

Pod Annotations(1)

ParameterTypeDefaultDescription
podAnnotationsobject-Additional annotations for the pod

Extra Volume Mounts(1)

ParameterTypeDefaultDescription
extraVolumeMountsarray-Additional volume mounts for the Pi-hole container

Extra Volumes(1)

ParameterTypeDefaultDescription
extraVolumesarray-Additional volumes for the pod

Extra Manifests(1)

ParameterTypeDefaultDescription
extraManifestsarray-Extra Kubernetes manifests to deploy alongside the chart

Gateway(6)

ParameterTypeDefaultDescription
gateway.enabledbooleanfalseChart configuration parameter
gateway.annotationsobject-Chart configuration parameter
gateway.parentRefsarray-Chart configuration parameter
gateway.hostnamesarray-Chart configuration parameter
gateway.pathstring/Chart configuration parameter
gateway.pathTypestringPathPrefixChart configuration parameter
Allowed:PathPrefixExactRegularExpression

External Secrets(7)

ParameterTypeDefaultDescription
externalSecrets.enabledbooleanfalseChart configuration parameter
externalSecrets.apiVersionstringexternal-secrets.io/v1Chart configuration parameter
externalSecrets.refreshIntervalstring0Chart configuration parameter
externalSecrets.secretStoreRef.namestring-Chart configuration parameter
externalSecrets.secretStoreRef.kindstring-Chart configuration parameter
externalSecrets.target.creationPolicystring-Chart configuration parameter
externalSecrets.dataarray-Chart configuration parameter