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
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.
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
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.
DNS Records
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.
Gravity
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.
Persistence
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.
Services
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.
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
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.
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
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.
Metrics
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.
Backup
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.
Unbound
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.
DHCP
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.
Scheduling
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.
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
- Design rationale — scope, security, production boundaries, and known gaps
- Unbound Recursive DNS — privacy-focused recursive DNS resolution
- Operations guide — backup, upgrades, runtime verification, and troubleshooting
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 SyncedVerified 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)]
Pi-hole Values Schema Reference
Official schema parameters, default values, and types extracted directly from the chart repository.
Global(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| global | object | - | Global settings shared by the chart. |
Name Override(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| nameOverride | string | "" | Override the chart name used in resource names |
Fullname Override(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| fullnameOverride | string | "" | Override the full release name used in resource names |
Common Labels(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| commonLabels | object | - | Labels added to every resource created by this chart |
Common Annotations(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| commonAnnotations | object | - | Annotations added to every chart-managed resource (not pod templates) |
Image(4)
| Parameter | Type | Default | Description |
|---|---|---|---|
| image.repository | string | docker.io/pihole/pihole | Container image repository |
| image.tag | string | 2026.10.0 | Container image tag |
| image.digest | string | - | Chart configuration parameter |
| image.pullPolicy | string | IfNotPresent | Image pull policy Allowed: AlwaysIfNotPresentNever |
Image Pull Secrets(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| imagePullSecrets | array | - | Image pull secrets for private registries |
Container Ports(2)
| Parameter | Type | Default | Description |
|---|---|---|---|
| containerPorts.dns | integer | 53 | Chart configuration parameter |
| containerPorts.http | integer | 80 | Chart configuration parameter |
Pihole(14)
| Parameter | Type | Default | Description |
|---|---|---|---|
| pihole.timezone | string | UTC | Timezone for logs and scheduled tasks |
| pihole.upstreamDns | string | 8.8.8.8;8.8.4.4 | Upstream DNS servers (semicolon-delimited). When unbound sidecar is enabled, this is overridden to 127.0.0.1#5335. |
| pihole.listeningMode | string | ALL | DNS listening mode Allowed: LOCALALLSINGLEBIND |
| pihole.webserverPort | string | "" | Full Pi-hole FTL webserver.port value. Empty derives from containerPorts.http. The primary port must serve HTTP directly on all pod interfaces. |
| pihole.dnssec | boolean | false | Enable DNSSEC validation |
| pihole.ftl.cacheSize | integer | 10000 | DNS cache size |
| pihole.ftl.privacyLevel | integer | 0 | Privacy level (0-3) |
| pihole.ftl.cnameInspection | boolean | true | Block CNAME-cloaked trackers |
| pihole.ftl.rateLimit | integer | 1000 | Rate limiting query count per client; set to 0 to disable rate limiting |
| pihole.ftl.rateLimitInterval | integer | 60 | Rate limiting interval in seconds |
| pihole.ftl.blockAAAA | boolean | false | Block AAAA queries on A-only networks |
| pihole.ftl.queryLogging | boolean | true | Query logging |
| pihole.ftl.useDatabase | boolean | true | Use database for queries (required for long-term stats) |
| pihole.extraEnv | array | - | Additional environment variables for the Pi-hole container |
Admin(3)
| Parameter | Type | Default | Description |
|---|---|---|---|
| admin.password | string | "" | Web admin password (auto-generated if empty and no existingSecret) |
| admin.existingSecret | string | "" | Use an existing secret for the admin password |
| admin.existingSecretKey | string | password | Key in the existing secret that contains the admin password |
Dns(18)
| Parameter | Type | Default | Description |
|---|---|---|---|
| dns.preset | string | none | Blocklist preset Allowed: nonebasicbalancedaggressivegaming-friendly |
| dns.adlists | array | - | Custom blocklist URLs (added to preset) |
| dns.whitelistPresets.microsoft | boolean | false | Whitelist Microsoft services |
| dns.whitelistPresets.apple | boolean | false | Whitelist Apple services |
| dns.whitelistPresets.google | boolean | false | Whitelist Google services |
| dns.whitelistPresets.gaming | boolean | false | Whitelist gaming platforms |
| dns.whitelistPresets.smartHome | boolean | false | Whitelist smart home devices |
| dns.whitelist | array | - | Manual whitelisted domains (added to presets) |
| dns.blacklist | array | - | Blacklisted domains (exact matches) |
| dns.regex | array | - | Regex filters for blocking (advanced) |
| dns.conditionalForwarding.enabled | boolean | false | Enable conditional forwarding |
| dns.conditionalForwarding.domain | string | "" | Local network domain |
| dns.conditionalForwarding.network | string | "" | Local network CIDR |
| dns.conditionalForwarding.router | string | "" | Router/DNS server IP for reverse lookups |
| dns.conditionalForwarding.customRules | array | - | Additional conditional forwarding rules |
| dns.customRecords | array | - | Custom local DNS A records (each entry: "IP HOSTNAME") |
| dns.cnameRecords | array | - | Custom CNAME records (dnsmasq format) |
| dns.customDnsmasq | array | - | Custom dnsmasq configuration lines |
Persistence(6)
| Parameter | Type | Default | Description |
|---|---|---|---|
| persistence.enabled | boolean | true | Enable persistent storage for /etc/pihole |
| persistence.storageClass | string | "" | Storage class (leave empty for cluster default) |
| persistence.accessMode | string | ReadWriteOnce | Access mode for the PVC |
| persistence.size | string | 1Gi | Size of the persistent volume |
| persistence.existingClaim | string | "" | Use an existing PVC instead of creating one |
| persistence.annotations | object | - | Annotations for the PVC |
Gravity(10)
| Parameter | Type | Default | Description |
|---|---|---|---|
| gravity.enabled | boolean | true | Enable automated gravity database initialization |
| gravity.updateOnInit | boolean | true | Run pihole -g after populating database |
| gravity.resources.requests.cpu | stringnumber | - | Chart configuration parameter |
| gravity.resources.requests.memory | stringnumber | - | Chart configuration parameter |
| gravity.resources.limits.cpu | stringnumber | - | Chart configuration parameter |
| gravity.resources.limits.memory | stringnumber | - | Chart configuration parameter |
| gravity.updateResources.requests.cpu | stringnumber | - | Chart configuration parameter |
| gravity.updateResources.requests.memory | stringnumber | - | Chart configuration parameter |
| gravity.updateResources.limits.cpu | stringnumber | - | Chart configuration parameter |
| gravity.updateResources.limits.memory | stringnumber | - | Chart configuration parameter |
Backup(33)
| Parameter | Type | Default | Description |
|---|---|---|---|
| backup.enabled | boolean | false | Enable automated backups to S3 |
| backup.schedule | string | 0 3 * * * | Backup schedule (cron format) |
| backup.backoffLimit | integer | 1 | Chart configuration parameter |
| backup.successfulJobsHistoryLimit | integer | 3 | Chart configuration parameter |
| backup.failedJobsHistoryLimit | integer | 1 | Chart configuration parameter |
| backup.concurrencyPolicy | string | Forbid | Chart configuration parameter Allowed: ForbidAllowReplace |
| backup.include.gravity | boolean | true | Chart configuration parameter |
| backup.include.customDns | boolean | true | Chart configuration parameter |
| backup.include.dnsmasq | boolean | true | Chart configuration parameter |
| backup.images.utility.repository | string | - | Chart configuration parameter |
| backup.images.utility.tag | string | - | Chart configuration parameter |
| backup.images.utility.digest | string | - | Chart configuration parameter |
| backup.images.utility.pullPolicy | string | - | Chart configuration parameter Allowed: AlwaysIfNotPresentNever |
| backup.images.uploader.repository | string | - | Chart configuration parameter |
| backup.images.uploader.tag | string | - | Chart configuration parameter |
| backup.images.uploader.digest | string | - | Chart configuration parameter |
| backup.images.uploader.pullPolicy | string | - | Chart configuration parameter Allowed: AlwaysIfNotPresentNever |
| backup.resources.requests.cpu | stringnumber | - | Chart configuration parameter |
| backup.resources.requests.memory | stringnumber | - | Chart configuration parameter |
| backup.resources.limits.cpu | stringnumber | - | Chart configuration parameter |
| backup.resources.limits.memory | stringnumber | - | Chart configuration parameter |
| backup.serviceAccount.create | boolean | true | Chart configuration parameter |
| backup.serviceAccount.name | string | "" | Chart configuration parameter |
| backup.serviceAccount.annotations | object | - | Chart configuration parameter |
| backup.serviceAccount.automountServiceAccountToken | boolean | false | Chart configuration parameter |
| backup.s3.endpoint | string | - | Chart configuration parameter |
| backup.s3.bucket | string | - | Chart configuration parameter |
| backup.s3.prefix | string | pihole | Chart configuration parameter |
| backup.s3.existingSecret | string | - | Chart configuration parameter |
| backup.s3.accessKey | string | - | Chart configuration parameter |
| backup.s3.secretKey | string | - | Chart configuration parameter |
| backup.s3.region | string | "" | Chart configuration parameter |
| backup.s3.credentialsFromPodIdentity | boolean | false | Chart configuration parameter |
Resources(4)
| Parameter | Type | Default | Description |
|---|---|---|---|
| resources.requests.cpu | stringnumber | - | Chart configuration parameter |
| resources.requests.memory | stringnumber | - | Chart configuration parameter |
| resources.limits.cpu | stringnumber | - | Chart configuration parameter |
| resources.limits.memory | stringnumber | - | Chart configuration parameter |
Host Network(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| hostNetwork | boolean | false | Use the host network for the main Pi-hole pod |
Dns Policy(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| dnsPolicy | string | "" | Pod DNS policy. Defaults to ClusterFirstWithHostNet when hostNetwork is enabled. Allowed: ClusterFirstWithHostNetClusterFirstDefaultNone |
Pod Security(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| podSecurityContext.seccompProfile.type | string | - | Chart configuration parameter Allowed: RuntimeDefaultLocalhostUnconfined |
Container Security(3)
| Parameter | Type | Default | Description |
|---|---|---|---|
| securityContext.allowPrivilegeEscalation | boolean | - | Chart configuration parameter |
| securityContext.capabilities.add | array | - | Chart configuration parameter |
| securityContext.capabilities.drop | array | - | Chart configuration parameter |
Startup Probe(5)
| Parameter | Type | Default | Description |
|---|---|---|---|
| startupProbe.enabled | boolean | true | Enable startup probe |
| startupProbe.initialDelaySeconds | integer | - | Chart configuration parameter |
| startupProbe.periodSeconds | integer | - | Chart configuration parameter |
| startupProbe.timeoutSeconds | integer | - | Chart configuration parameter |
| startupProbe.failureThreshold | integer | - | Chart configuration parameter |
Liveness Probe(5)
| Parameter | Type | Default | Description |
|---|---|---|---|
| livenessProbe.enabled | boolean | true | Enable liveness probe |
| livenessProbe.initialDelaySeconds | integer | - | Chart configuration parameter |
| livenessProbe.periodSeconds | integer | - | Chart configuration parameter |
| livenessProbe.timeoutSeconds | integer | - | Chart configuration parameter |
| livenessProbe.failureThreshold | integer | - | Chart configuration parameter |
Readiness Probe(5)
| Parameter | Type | Default | Description |
|---|---|---|---|
| readinessProbe.enabled | boolean | true | Enable readiness probe |
| readinessProbe.initialDelaySeconds | integer | - | Chart configuration parameter |
| readinessProbe.periodSeconds | integer | - | Chart configuration parameter |
| readinessProbe.timeoutSeconds | integer | - | Chart configuration parameter |
| readinessProbe.failureThreshold | integer | - | Chart configuration parameter |
Service Dns(7)
| Parameter | Type | Default | Description |
|---|---|---|---|
| serviceDns.type | string | LoadBalancer | Service type for DNS Allowed: ClusterIPNodePortLoadBalancer |
| serviceDns.port | integer | 53 | DNS port |
| serviceDns.annotations | object | - | Annotations for the DNS service |
| serviceDns.externalTrafficPolicy | string | - | External traffic policy (set to Local for client IP preservation) |
| serviceDns.loadBalancerIP | string | - | Load balancer IP (set a fixed IP for DNS stability) |
| serviceDns.ipFamilyPolicy | stringnull | - | Dual-stack ipFamilyPolicy (GR-058) Allowed: nullSingleStackPreferDualStackRequireDualStack |
| serviceDns.ipFamilies | array | - | Dual-stack ipFamilies (GR-058) |
Service Web(5)
| Parameter | Type | Default | Description |
|---|---|---|---|
| serviceWeb.type | string | ClusterIP | Service type for web admin Allowed: ClusterIPNodePortLoadBalancer |
| serviceWeb.port | integer | 80 | Web admin HTTP port |
| serviceWeb.annotations | object | - | Annotations for the web service |
| serviceWeb.ipFamilyPolicy | stringnull | - | Dual-stack ipFamilyPolicy (GR-058) Allowed: nullSingleStackPreferDualStackRequireDualStack |
| serviceWeb.ipFamilies | array | - | Dual-stack ipFamilies (GR-058) |
Ingress(5)
| Parameter | Type | Default | Description |
|---|---|---|---|
| ingress.enabled | boolean | false | Enable ingress for the web admin interface |
| ingress.ingressClassName | string | "" | Ingress class name |
| ingress.annotations | object | - | Ingress annotations |
| ingress.hosts | array | - | Ingress hosts |
| ingress.tls | array | - | Ingress TLS configuration |
Service Account(4)
| Parameter | Type | Default | Description |
|---|---|---|---|
| serviceAccount.create | boolean | false | Create a dedicated ServiceAccount |
| serviceAccount.name | string | "" | Name override (auto-generated if empty) |
| serviceAccount.annotations | object | - | Annotations for the ServiceAccount |
| serviceAccount.automountServiceAccountToken | boolean | false | Mount the Kubernetes API token into the Pi-hole pod |
Metrics & Observability(15)
| Parameter | Type | Default | Description |
|---|---|---|---|
| metrics.enabled | boolean | false | Enable Prometheus metrics via pihole-exporter sidecar |
| metrics.image.repository | string | docker.io/ekofr/pihole-exporter | pihole-exporter image repository |
| metrics.image.tag | string | v1.2.0 | pihole-exporter image tag |
| metrics.image.digest | string | - | Chart configuration parameter |
| metrics.image.pullPolicy | string | IfNotPresent | pihole-exporter pull policy Allowed: AlwaysIfNotPresentNever |
| metrics.port | integer | 9617 | Port for the Prometheus metrics endpoint |
| metrics.resources.requests.cpu | stringnumber | - | Chart configuration parameter |
| metrics.resources.requests.memory | stringnumber | - | Chart configuration parameter |
| metrics.resources.limits.cpu | stringnumber | - | Chart configuration parameter |
| metrics.resources.limits.memory | stringnumber | - | Chart configuration parameter |
| metrics.securityContext.allowPrivilegeEscalation | boolean | - | Chart configuration parameter |
| metrics.securityContext.capabilities.drop | array | - | Chart configuration parameter |
| metrics.serviceMonitor.enabled | boolean | false | Create a ServiceMonitor resource |
| metrics.serviceMonitor.interval | string | 30s | Scrape interval |
| metrics.serviceMonitor.labels | object | - | Additional labels for the ServiceMonitor |
Unbound(15)
| Parameter | Type | Default | Description |
|---|---|---|---|
| unbound.enabled | boolean | false | Enable Unbound sidecar for recursive DNS resolution |
| unbound.image.repository | string | docker.io/mvance/unbound | Unbound image repository |
| unbound.image.tag | string | 1.22.0 | Unbound image tag |
| unbound.image.digest | string | - | Chart configuration parameter |
| unbound.image.pullPolicy | string | IfNotPresent | Unbound pull policy Allowed: AlwaysIfNotPresentNever |
| unbound.port | integer | 5335 | Unbound listening port inside the pod |
| unbound.config | string | "" | Full unbound.conf override. When empty, a sensible default binding 127.0.0.1 at unbound.port is rendered. |
| unbound.extraConfig | string | "" | Extra unbound directives appended inside the default server: section. Ignored when unbound.config is set. |
| unbound.resources.requests.cpu | stringnumber | - | Chart configuration parameter |
| unbound.resources.requests.memory | stringnumber | - | Chart configuration parameter |
| unbound.resources.limits.cpu | stringnumber | - | Chart configuration parameter |
| unbound.resources.limits.memory | stringnumber | - | Chart configuration parameter |
| unbound.securityContext.allowPrivilegeEscalation | boolean | - | Chart configuration parameter |
| unbound.securityContext.capabilities.add | array | - | Chart configuration parameter |
| unbound.securityContext.capabilities.drop | array | - | Chart configuration parameter |
Network Policy(2)
| Parameter | Type | Default | Description |
|---|---|---|---|
| networkPolicy.enabled | boolean | true | Chart configuration parameter |
| networkPolicy.ingressFrom | array | - | Chart configuration parameter |
Dhcp(6)
| Parameter | Type | Default | Description |
|---|---|---|---|
| dhcp.enabled | boolean | false | Enable DHCP server |
| dhcp.hostNetwork | boolean | false | Use host network for DHCP broadcasts |
| dhcp.start | string | - | First IPv4 address in the DHCP lease range |
| dhcp.end | string | - | Last IPv4 address in the DHCP lease range |
| dhcp.router | string | - | Router IPv4 address advertised to DHCP clients |
| dhcp.leaseTime | string | - | DHCP lease time |
Node Selector(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| nodeSelector | object | - | Node selector for pod scheduling |
Tolerations(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| tolerations | array | - | Tolerations for pod scheduling |
Affinity(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| affinity | object | - | Affinity rules for pod scheduling |
Topology Spread Constraints(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| topologySpreadConstraints | array | - | Topology spread constraints |
Priority Class Name(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| priorityClassName | string | "" | Priority class name |
Termination Grace Period Seconds(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| terminationGracePeriodSeconds | integer | 30 | Grace period for shutdown (seconds) |
Pod Labels(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| podLabels | object | - | Additional labels for the pod |
Pod Annotations(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| podAnnotations | object | - | Additional annotations for the pod |
Extra Volume Mounts(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| extraVolumeMounts | array | - | Additional volume mounts for the Pi-hole container |
Extra Volumes(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| extraVolumes | array | - | Additional volumes for the pod |
Extra Manifests(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| extraManifests | array | - | Extra Kubernetes manifests to deploy alongside the chart |
Gateway(6)
| Parameter | Type | Default | Description |
|---|---|---|---|
| gateway.enabled | boolean | false | Chart configuration parameter |
| gateway.annotations | object | - | Chart configuration parameter |
| gateway.parentRefs | array | - | Chart configuration parameter |
| gateway.hostnames | array | - | Chart configuration parameter |
| gateway.path | string | / | Chart configuration parameter |
| gateway.pathType | string | PathPrefix | Chart configuration parameter Allowed: PathPrefixExactRegularExpression |
External Secrets(7)
| Parameter | Type | Default | Description |
|---|---|---|---|
| externalSecrets.enabled | boolean | false | Chart configuration parameter |
| externalSecrets.apiVersion | string | external-secrets.io/v1 | Chart configuration parameter |
| externalSecrets.refreshInterval | string | 0 | Chart configuration parameter |
| externalSecrets.secretStoreRef.name | string | - | Chart configuration parameter |
| externalSecrets.secretStoreRef.kind | string | - | Chart configuration parameter |
| externalSecrets.target.creationPolicy | string | - | Chart configuration parameter |
| externalSecrets.data | array | - | Chart configuration parameter |
No schema parameters match your search
Try searching for a different keyword or reset the filter.