Skip to content
phpMyAdmin icon
v2.2.1App: v5.2.3Pinned DigestS3 Backup Ready

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

phpMyAdmin

A Helm chart for deploying phpMyAdmin on Kubernetes with the official phpmyadmin image.

phpMyAdmin is a web UI for administering MySQL and MariaDB. This chart supports development installs, internal administration portals, and hardened production-style deployments with External Secrets, Gateway API, NetworkPolicy, dual-stack Services, optional shared sessions, and Kubernetes-native availability controls.

Install

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

OCI:

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

Quick Start

helm install phpmyadmin oci://ghcr.io/helmforgedev/helm/phpmyadmin \
  --set phpmyadmin.host=mysql.default.svc.cluster.local

Local access:

kubectl port-forward svc/phpmyadmin 8080:80

Open http://localhost:8080/.

Feature Summary

  • Official phpmyadmin container image.
  • Single-server, multi-server, and arbitrary-server login modes.
  • Cookie, config, HTTP, and signon auth mode selection.
  • Optional auto-login with inline Secret, existing Secret, or External Secrets Operator.
  • External Secrets Operator support with external-secrets.io/v1.
  • Ingress and Kubernetes Gateway API HTTPRoute.
  • Service dual-stack options through ipFamilyPolicy and ipFamilies.
  • Optional NetworkPolicy for ingress and database egress.
  • Optional ServiceAccount token automount control.
  • Optional HPA and PodDisruptionBudget.
  • Optional /sessions mount for multi-replica session stability.
  • Optional custom phpMyAdmin config through ConfigMap or PMA_CONFIG_BASE64.
  • Optional configuration storage/control user variables.
  • Optional custom themes mounted at /www/themes.

Application Listener

containerPorts.http configures the real Apache listener through the official image's APACHE_PORT environment variable. It also controls the container port, probes, and NetworkPolicy ingress rule. service.port is the independent Kubernetes Service port and routes to the named http target.

containerPorts:
  http: 8088

service:
  port: 80

Changing only service.port does not change Apache. Use containerPorts.http when the process must listen on a different port.

Development vs Production

The default values are intentionally simple for development: one replica, no Ingress/Gateway, no NetworkPolicy, no ExternalSecret, and access through port-forward. This keeps a local install easy.

Production deployments should opt into the controls they need:

  • Use auth.existingSecret or externalSecrets.auth instead of inline passwords.
  • Prefer phpmyadmin.authType: cookie unless a controlled config, http, or signon workflow is required.
  • Expose phpMyAdmin through private networking, VPN, SSO/reverse proxy auth, or IP allowlists.
  • Enable TLS at the Ingress or Gateway layer.
  • Enable NetworkPolicy and restrict egress to DNS and the target database.
  • Use least-privilege database accounts.
  • Enable sessions.enabled for multi-replica deployments that rely on cookie/session state.
  • Add requests, limits, PDB, HPA, topology spread, and anti-affinity where appropriate.

Database Connectivity

Single MySQL/MariaDB server:

phpmyadmin:
  host: mysql.default.svc.cluster.local
  port: 3306

Multi-server dropdown:

phpmyadmin:
  hosts: "mysql-primary.default.svc,mysql-replica.default.svc,mariadb.default.svc"
  ports: "3306,3306,3306"
  verboses: "Primary,Replica,MariaDB"

Arbitrary server mode:

phpmyadmin:
  arbitrary: true

Authentication

Default cookie login:

phpmyadmin:
  authType: cookie
auth:
  blowfishSecret: "use-a-32-byte-random-secret-here"

Non-cookie auth modes are rendered into config.user.inc.php because the official phpMyAdmin image does not consume an auth-type environment variable:

phpmyadmin:
  authType: http

When authType: http is used, the chart automatically switches the default probes to TCP checks because the application root returns 401 until HTTP authentication succeeds.

Auto-login with an existing Secret:

auth:
  existingSecret: phpmyadmin-auth
  existingSecretUsernameKey: username
  existingSecretPasswordKey: password
  existingSecretBlowfishKey: blowfish-secret

The Secret should contain:

apiVersion: v1
kind: Secret
metadata:
  name: phpmyadmin-auth
type: Opaque
stringData:
  username: admin
  password: change-me
  blowfish-secret: use-a-32-byte-random-secret-here

Auto-login skips the login form and should only be used behind strong network and identity controls. When a blowfish secret is provided inline, by existing Secret, or by External Secrets Operator, the chart exposes it to the pod as HELMFORGE_BLOWFISH_SECRET and writes $cfg['blowfish_secret'] through config.user.inc.php.

External Secrets Operator

The chart can render an ExternalSecret using external-secrets.io/v1. The External Secrets Operator and the referenced SecretStore or ClusterSecretStore must already exist.

externalSecrets:
  enabled: true
  secretStoreRef:
    name: platform-secrets
    kind: ClusterSecretStore
  auth:
    enabled: true
    usernameRemoteRef:
      key: prod/phpmyadmin
      property: username
    passwordRemoteRef:
      key: prod/phpmyadmin
      property: password
    blowfishSecretRemoteRef:
      key: prod/phpmyadmin
      property: blowfish-secret

Ingress

phpmyadmin:
  host: mysql.default.svc.cluster.local
  absoluteUri: "https://pma.example.com/"

ingress:
  enabled: true
  ingressClassName: nginx
  annotations:
    cert-manager.io/cluster-issuer: letsencrypt-prod
  hosts:
    - host: pma.example.com
      paths:
        - path: /
          pathType: Prefix
  tls:
    - secretName: phpmyadmin-tls
      hosts:
        - pma.example.com

Gateway API

Gateway API support is opt-in and creates an HTTPRoute attached to an existing Gateway.

gatewayAPI:
  enabled: true
  parentRefs:
    - name: public
      namespace: gateway-system
      sectionName: https
  hostnames:
    - pma.example.com

Service Dual Stack

Dual-stack is disabled by default and inherits the cluster default. Enable it only on clusters configured for IPv4/IPv6 Services.

service:
  ipFamilyPolicy: PreferDualStack
  ipFamilies:
    - IPv4
    - IPv6

NetworkPolicy

networkPolicy:
  enabled: true
  ingress:
    allowSameNamespace: true
  egress:
    enabled: true
    allowDNS: true
    allowSameNamespaceDatabase: true
    databasePort: 3306

Use extraFrom and extraTo to restrict traffic to Gateway/Ingress controller namespaces and database CIDRs or pod selectors.

Sessions And Replicas

phpMyAdmin is mostly stateless, but cookie/session flows benefit from a shared /sessions mount when running multiple replicas.

replicaCount: 2
sessions:
  enabled: true
  type: persistentVolumeClaim
  accessModes:
    - ReadWriteMany
  size: 1Gi

For clusters without shared storage, keep replicaCount: 1 or use ingress stickiness.

Custom Configuration

Mount config.user.inc.php:

config:
  customConfig: |
    <?php
    $cfg['ShowPhpInfo'] = false;
    $cfg['MaxRows'] = 100;

The chart also generates config.user.inc.php when it needs to apply phpmyadmin.authType values other than cookie or a configured blowfish secret. If config.customConfig is set, the custom block is appended after the generated block so advanced users can still override phpMyAdmin settings deliberately.

Or pass base64 configuration through the official image variable:

phpmyadmin:
  configBase64: "PD9waHAKJGNmZ1snU2hvd1BocEluZm8nXSA9IGZhbHNlOwo="

Production Example

See examples/production.yaml.

Architecture Guides

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

| --- | --- | --- | | containerPorts.http | 80 | Actual Apache HTTP listener | | phpmyadmin.host | "" | Single MySQL/MariaDB host | | phpmyadmin.hosts | "" | Comma-separated multi-server hosts | | phpmyadmin.ports | "" | Comma-separated multi-server ports | | phpmyadmin.verboses | "" | Comma-separated server display names | | phpmyadmin.arbitrary | false | Let users enter a host at login | | phpmyadmin.authType | cookie | phpMyAdmin auth mode | | phpmyadmin.uploadLimit | 64M | SQL import upload limit | | phpmyadmin.absoluteUri | "" | External URL when behind a proxy | | auth.existingSecret | "" | Existing auth Secret | | externalSecrets.enabled | false | Render ExternalSecret resources | | gatewayAPI.enabled | false | Render HTTPRoute | | service.ipFamilyPolicy | "" | Service IP family policy | | service.ipFamilies | [] | Service IP families | | networkPolicy.enabled | false | Render NetworkPolicy | | sessions.enabled | false | Mount /sessions | | autoscaling.enabled | false | Render HPA | | pdb.enabled | false | Render PDB | | serviceAccount.automountServiceAccountToken | false | Mount SA token into pods |

Validation

Recommended checks before promotion:

helm lint charts/phpmyadmin
helm unittest charts/phpmyadmin
helm template phpmyadmin charts/phpmyadmin -f charts/phpmyadmin/examples/production.yaml

For cluster validation, install into K3D/K3S with a test MySQL/MariaDB target and check pods, logs, events, Service endpoints, Ingress or Gateway route, and ExternalSecret reconciliation when ESO is enabled.

Security Scan: phpmyadmin

Framework Score
MITRE + NSA + SOC2 75.757576%

Security posture: acceptable.

References

System Architecture

DESIGN.md Synced

Verified architecture contract rendered dynamically from GitHub DESIGN.md

flowchart LR
  User[Administrator browser] --> Edge[Ingress or Gateway API]
  Edge --> Service[phpMyAdmin Service]
  Service --> Web[phpMyAdmin and Apache pod]
  Web --> Database[(MySQL or MariaDB servers)]
  Auth[Credential Secret or ExternalSecret] --> Web
  Config[Generated or custom configuration] --> Web
  Sessions[(Optional shared session PVC)] --> Web
  HPA[HorizontalPodAutoscaler] --> Web
Official Contractvalues.schema.json

phpMyAdmin Values Schema Reference

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

135 parametersValues Studio

Global(1)

ParameterTypeDefaultDescription
globalobject-Global settings shared by the chart.

Name Override(1)

ParameterTypeDefaultDescription
nameOverridestring-Chart configuration parameter

Fullname Override(1)

ParameterTypeDefaultDescription
fullnameOverridestring-Chart configuration parameter

Common Labels(1)

ParameterTypeDefaultDescription
commonLabelsobject-Chart configuration parameter

Image(3)

ParameterTypeDefaultDescription
image.repositorystring-Chart configuration parameter
image.tagstring-Chart configuration parameter
image.pullPolicystring-Chart configuration parameter
Allowed:AlwaysIfNotPresentNever

Image Pull Secrets(1)

ParameterTypeDefaultDescription
imagePullSecretsarray-Chart configuration parameter

Replica Count(1)

ParameterTypeDefaultDescription
replicaCountinteger-Chart configuration parameter

Phpmyadmin(21)

ParameterTypeDefaultDescription
phpmyadmin.hoststring-Chart configuration parameter
phpmyadmin.hostsstring-Chart configuration parameter
phpmyadmin.verbosesstring-Chart configuration parameter
phpmyadmin.portinteger-Chart configuration parameter
phpmyadmin.portsstring-Chart configuration parameter
phpmyadmin.arbitraryboolean-Chart configuration parameter
phpmyadmin.uploadLimitstring-Chart configuration parameter
phpmyadmin.absoluteUristring-Chart configuration parameter
phpmyadmin.hidePhpVersionboolean-Chart configuration parameter
phpmyadmin.configBase64string-Chart configuration parameter
phpmyadmin.authTypestring-Chart configuration parameter
Allowed:cookieconfighttpsignon
phpmyadmin.controlHoststring-Chart configuration parameter
phpmyadmin.controlPortinteger-Chart configuration parameter
phpmyadmin.controlUserstring-Chart configuration parameter
phpmyadmin.controlPasswordstring-Chart configuration parameter
phpmyadmin.ssl.enabledboolean-Chart configuration parameter
phpmyadmin.ssl.verifyboolean-Chart configuration parameter
phpmyadmin.ssl.caPathstring-Chart configuration parameter
phpmyadmin.ssl.certPathstring-Chart configuration parameter
phpmyadmin.ssl.keyPathstring-Chart configuration parameter
phpmyadmin.extraEnvarray-Chart configuration parameter

Authentication(8)

ParameterTypeDefaultDescription
auth.usernamestring-Chart configuration parameter
auth.passwordstring-Chart configuration parameter
auth.blowfishSecretstring-Chart configuration parameter
auth.existingSecretstring-Chart configuration parameter
auth.existingSecretUsernameKeystring-Chart configuration parameter
auth.existingSecretPasswordKeystring-Chart configuration parameter
auth.existingSecretBlowfishKeystring-Chart configuration parameter
auth.existingSecretControlPasswordKeystring-Chart configuration parameter

Configuration(2)

ParameterTypeDefaultDescription
config.customConfigstring-Chart configuration parameter
config.existingConfigMapstring-Chart configuration parameter

Resources(1)

ParameterTypeDefaultDescription
resourcesobject-Chart configuration parameter

Pod Security(1)

ParameterTypeDefaultDescription
podSecurityContextobject-Chart configuration parameter

Container Security(1)

ParameterTypeDefaultDescription
securityContextobject-Chart configuration parameter

Startup Probe(6)

ParameterTypeDefaultDescription
startupProbe.enabledboolean-Chart configuration parameter
startupProbe.pathstring-Chart configuration parameter
startupProbe.initialDelaySecondsinteger-Chart configuration parameter
startupProbe.periodSecondsinteger-Chart configuration parameter
startupProbe.timeoutSecondsinteger-Chart configuration parameter
startupProbe.failureThresholdinteger-Chart configuration parameter

Liveness Probe(6)

ParameterTypeDefaultDescription
livenessProbe.enabledboolean-Chart configuration parameter
livenessProbe.pathstring-Chart configuration parameter
livenessProbe.initialDelaySecondsinteger-Chart configuration parameter
livenessProbe.periodSecondsinteger-Chart configuration parameter
livenessProbe.timeoutSecondsinteger-Chart configuration parameter
livenessProbe.failureThresholdinteger-Chart configuration parameter

Readiness Probe(6)

ParameterTypeDefaultDescription
readinessProbe.enabledboolean-Chart configuration parameter
readinessProbe.pathstring-Chart configuration parameter
readinessProbe.initialDelaySecondsinteger-Chart configuration parameter
readinessProbe.periodSecondsinteger-Chart configuration parameter
readinessProbe.timeoutSecondsinteger-Chart configuration parameter
readinessProbe.failureThresholdinteger-Chart configuration parameter

Service & Networking(5)

ParameterTypeDefaultDescription
service.typestring-Chart configuration parameter
Allowed:ClusterIPNodePortLoadBalancer
service.portinteger-Chart configuration parameter
service.annotationsobject-Chart configuration parameter
service.ipFamilyPolicystring-Chart configuration parameter
Allowed:SingleStackPreferDualStackRequireDualStack
service.ipFamiliesarray-Chart configuration parameter

Ingress(5)

ParameterTypeDefaultDescription
ingress.enabledboolean-Chart configuration parameter
ingress.ingressClassNamestring-Chart configuration parameter
ingress.annotationsobject-Chart configuration parameter
ingress.hostsarray-Chart configuration parameter
ingress.tlsarray-Chart configuration parameter

Gateway API(6)

ParameterTypeDefaultDescription
gatewayAPI.enabledboolean-Chart configuration parameter
gatewayAPI.apiVersionstring-Chart configuration parameter
Allowed:gateway.networking.k8s.io/v1
gatewayAPI.annotationsobject-Chart configuration parameter
gatewayAPI.parentRefsarray-Chart configuration parameter
gatewayAPI.hostnamesarray-Chart configuration parameter
gatewayAPI.matchesarray-Chart configuration parameter

Service Account(4)

ParameterTypeDefaultDescription
serviceAccount.createboolean-Chart configuration parameter
serviceAccount.namestring-Chart configuration parameter
serviceAccount.annotationsobject-Chart configuration parameter
serviceAccount.automountServiceAccountTokenboolean-Chart configuration parameter

Autoscaling(5)

ParameterTypeDefaultDescription
autoscaling.enabledboolean-Chart configuration parameter
autoscaling.minReplicasinteger-Chart configuration parameter
autoscaling.maxReplicasinteger-Chart configuration parameter
autoscaling.targetCPUUtilizationPercentageinteger-Chart configuration parameter
autoscaling.targetMemoryUtilizationPercentageany-Chart configuration parameter

Pdb(3)

ParameterTypeDefaultDescription
pdb.enabledboolean-Chart configuration parameter
pdb.minAvailableany-Chart configuration parameter
pdb.maxUnavailableany-Chart configuration parameter

Sessions(6)

ParameterTypeDefaultDescription
sessions.enabledboolean-Chart configuration parameter
sessions.typestring-Chart configuration parameter
Allowed:emptyDirpersistentVolumeClaim
sessions.existingClaimstring-Chart configuration parameter
sessions.storageClassstring-Chart configuration parameter
sessions.accessModesarray-Chart configuration parameter
sessions.sizestring-Chart configuration parameter

Themes(2)

ParameterTypeDefaultDescription
themes.enabledboolean-Chart configuration parameter
themes.volumeobject-Chart configuration parameter

Network Policy(10)

ParameterTypeDefaultDescription
networkPolicy.enabledboolean-Chart configuration parameter
networkPolicy.ingress.allowSameNamespaceboolean-Chart configuration parameter
networkPolicy.ingress.extraFromarray-Chart configuration parameter
networkPolicy.egress.enabledboolean-Chart configuration parameter
networkPolicy.egress.allowDNSboolean-Chart configuration parameter
networkPolicy.egress.allowSameNamespaceDatabaseboolean-Chart configuration parameter
networkPolicy.egress.databasePortinteger-Chart configuration parameter
networkPolicy.egress.allowHTTPSboolean-Chart configuration parameter
networkPolicy.egress.extraToarray-Chart configuration parameter
networkPolicy.egress.extraEgressarray-Additional raw NetworkPolicy egress rules (HelmForge standard)

External Secrets(16)

ParameterTypeDefaultDescription
externalSecrets.enabledboolean-Chart configuration parameter
externalSecrets.apiVersionstring-Chart configuration parameter
Allowed:external-secrets.io/v1
externalSecrets.refreshIntervalstring-Chart configuration parameter
externalSecrets.secretStoreRef.namestring-Chart configuration parameter
externalSecrets.secretStoreRef.kindstring-Chart configuration parameter
Allowed:SecretStoreClusterSecretStore
externalSecrets.target.creationPolicystring-Chart configuration parameter
Allowed:OwnerMergeNoneOrphan
externalSecrets.auth.enabledboolean-Chart configuration parameter
externalSecrets.auth.targetNamestring-Chart configuration parameter
externalSecrets.auth.usernameRemoteRef.keystring-Chart configuration parameter
externalSecrets.auth.usernameRemoteRef.propertystring-Chart configuration parameter
externalSecrets.auth.passwordRemoteRef.keystring-Chart configuration parameter
externalSecrets.auth.passwordRemoteRef.propertystring-Chart configuration parameter
externalSecrets.auth.blowfishSecretRemoteRef.keystring-Chart configuration parameter
externalSecrets.auth.blowfishSecretRemoteRef.propertystring-Chart configuration parameter
externalSecrets.auth.controlPasswordRemoteRef.keystring-Chart configuration parameter
externalSecrets.auth.controlPasswordRemoteRef.propertystring-Chart configuration parameter

Node Selector(1)

ParameterTypeDefaultDescription
nodeSelectorobject-Chart configuration parameter

Tolerations(1)

ParameterTypeDefaultDescription
tolerationsarray-Chart configuration parameter

Affinity(1)

ParameterTypeDefaultDescription
affinityobject-Chart configuration parameter

Topology Spread Constraints(1)

ParameterTypeDefaultDescription
topologySpreadConstraintsarray-Chart configuration parameter

Priority Class Name(1)

ParameterTypeDefaultDescription
priorityClassNamestring-Chart configuration parameter

Termination Grace Period Seconds(1)

ParameterTypeDefaultDescription
terminationGracePeriodSecondsinteger-Chart configuration parameter

Pod Labels(1)

ParameterTypeDefaultDescription
podLabelsobject-Chart configuration parameter

Pod Annotations(1)

ParameterTypeDefaultDescription
podAnnotationsobject-Chart configuration parameter

Extra Volume Mounts(1)

ParameterTypeDefaultDescription
extraVolumeMountsarray-Chart configuration parameter

Extra Volumes(1)

ParameterTypeDefaultDescription
extraVolumesarray-Chart configuration parameter

Extra Manifests(1)

ParameterTypeDefaultDescription
extraManifestsarray-Chart configuration parameter

Container Ports(1)

ParameterTypeDefaultDescription
containerPorts.httpinteger-Chart configuration parameter