Skip to content
Ghost icon
v1.3.3App: v6.71.0Pinned DigestS3 Backup Ready

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

Ghost Helm Chart

Deploy Ghost on Kubernetes using the official ghost container image. A modern publishing platform for building blogs, newsletters, and membership-based content with built-in monetization.

Features

  • MySQL backend — bundled via HelmForge subchart or external database
  • Content persistence — images, media, themes, routes, and redirects on PVC
  • S3 backup — scheduled content backups to S3-compatible storage
  • Headless CMS — REST and Content API for headless usage
  • Memberships — built-in subscriptions, newsletters, and payments
  • Ingress support — TLS with cert-manager
  • Gateway API support — optional HTTPRoute for modern ingress stacks
  • External Secrets support — optional database password synchronization
  • Hardened runtime defaults — non-root execution, read-only root filesystem, dropped capabilities, seccomp, and no API token mount
  • Operational policies — optional PodDisruptionBudget and NetworkPolicy with explicit database egress
  • Configurable listener — containerPorts.http updates the Ghost process, probes, Service target, and policies together

Installation

HTTPS repository:

helm repo add helmforge https://repo.helmforge.dev
helm repo update
helm install ghost helmforge/ghost -f values.yaml

OCI registry:

helm install ghost oci://ghcr.io/helmforgedev/helm/ghost -f values.yaml

Basic Example

# values.yaml
ghost:
  url: "https://blog.example.com"

After deploying:

kubectl port-forward svc/<release>-ghost 2368:80
# Open http://localhost:2368/ghost to set up admin account

Architecture

The chart runs one Ghost Deployment backed by a persistent content volume and either the bundled HelmForge MySQL dependency or an external MySQL-compatible database. A ClusterIP Service exposes the named http port to an optional Ingress or Gateway API HTTPRoute. See DESIGN.md for the trust boundaries and deployment diagrams.

External MySQL

mysql:
  enabled: false

database:
  external:
    host: "mysql.example.com"
    name: ghost
    username: ghost
    password: "secure-password"

External Secrets

External Secrets Operator can project the external MySQL password into the Secret consumed by Ghost. Install the operator separately, disable the bundled MySQL chart, and keep the item target aligned with database.external.existingSecret:

mysql:
  enabled: false

database:
  external:
    host: mysql.database.svc
    existingSecret: ghost-db-credentials

externalSecrets:
  enabled: true
  items:
    - fullnameOverride: ghost-db-credentials
      spec:
        secretStoreRef:
          name: platform-secrets
          kind: ClusterSecretStore
        data:
          - secretKey: password
            remoteRef:
              key: ghost/database
              property: password

The chart renders external-secrets.io/v1, defaults the target to the rendered ExternalSecret name, and supports multiple items. Every item must set either name or fullnameOverride so each resource has a unique identity. The legacy secretStoreRef/data surface remains compatible for existing releases, but new configurations should use externalSecrets.items.

Custom Adapter Images

Ghost can load adapters installed outside the content directory. For a custom image that installs adapters in /opt/ghost/adapters, expose the path through Ghost's environment-based configuration:

image:
  repository: registry.example.com/ghost-with-adapters
  tag: "6.71.0"

ghost:
  extraEnv:
    - name: paths__installedAdaptersPath
      value: /opt/ghost/adapters

Bake the adapter directory into the custom image. Keeping it outside /var/lib/ghost/content prevents the content PVC from shadowing installed adapters when the container starts.

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

|-----|---------|-------------| | ghost.url | "" | Public URL of the Ghost instance | | image.tag | 6.71.0 | Ghost image tag | | containerPorts.http | 2368 | Ghost process listener and container port | | commonAnnotations | {} | Annotations added to chart-owned resources; resource-specific annotations take precedence | | mysql.enabled | true | Deploy MySQL subchart | | mysql dependency | 2.2.0 | HelmForge MySQL chart version | | mysql.image.tag | 8.4.11 | MySQL image tag pinned to the Ghost-supported MySQL 8 major | | persistence.enabled | true | Enable content persistence | | persistence.size | 10Gi | Content PVC size | | serviceAccount.automountServiceAccountToken | false | Mount the Kubernetes API token into the Ghost application pod | | runtimeStorage.tmpSizeLimit | 256Mi | Maximum writable /tmp storage | | podDisruptionBudget.enabled | false | Protect the singleton pod during voluntary disruption | | networkPolicy.enabled | false | Restrict inbound traffic to Ghost | | networkPolicy.egress.enabled | false | Restrict egress to DNS, MySQL, and configured rules | | backup.enabled | false | Enable S3 content backups | | backup.s3.credentialsFromPodIdentity | false | Use ambient workload identity instead of static S3 keys | | backup.s3.region | "" | AWS region required for workload identity | | backup.serviceAccount.create | true | Create a dedicated backup ServiceAccount for workload identity | | backup.serviceAccount.annotations | {} | Workload identity annotations for the backup ServiceAccount | | backup.serviceAccount.automountServiceAccountToken | true | Mount the projected Kubernetes token required by workload identity | | ingress.enabled | false | Enable ingress | | gateway.enabled | false | Enable Gateway API HTTPRoute | | externalSecrets.enabled | false | Render ExternalSecret for database password | | externalSecrets.refreshInterval | 1h | Default sync interval for ExternalSecret items | | externalSecrets.items | [] | Complete ExternalSecret definitions |

Upgrade Notes

Upgrading a release that uses the bundled MySQL dependency from chart 2.1.x to 2.2.0 changes the MySQL StatefulSet checksum/config value. Kubernetes therefore performs a one-time rollout of the MySQL pod. The default standalone topology has one database replica, so Ghost can be temporarily unavailable until MySQL becomes ready. Schedule the upgrade during a maintenance window, take a database backup first, and wait for the MySQL StatefulSet rollout to complete before validating Ghost readiness.

Ghost 6.71.0 adds automation analytics, self-service site exports, member location maps and refreshed post/member screens. It also fixes scheduled-post races, member imports, Portal pricing and initialization, uploads, editor freezes, social previews and analytics links. Releases 6.66.0 through 6.71.0 do not document a breaking database or configuration change. Review the official release. Files edited in Ghost Admin remain under /var/lib/ghost/content/data, so the chart's content PVC and S3 content backup already cover them. Review the upstream Ghost release notes before upgrading production sites, take a content and database backup, and verify themes, custom integrations, newsletter flows, comments, and member signup paths in staging before reusing existing PVCs. The External Secrets contract now follows externalSecrets.items[]; the previous single-secret fields remain supported for compatibility.

S3 Backup

backup:
  enabled: true
  schedule: "0 3 * * *"
  s3:
    endpoint: "https://s3.example.com"
    bucket: ghost-backups
    accessKey: "minioadmin"
    secretKey: "minioadmin"

For AWS workload identity, omit static credentials and annotate the dedicated backup ServiceAccount:

backup:
  enabled: true
  serviceAccount:
    annotations:
      eks.amazonaws.com/role-arn: arn:aws:iam::123456789012:role/ghost-backup
  s3:
    endpoint: https://s3.amazonaws.com
    bucket: ghost-backups
    region: us-east-1
    credentialsFromPodIdentity: true

Security

The default pod runs as UID/GID 1000, uses RuntimeDefault seccomp, drops every Linux capability, prevents privilege escalation, mounts a read-only root filesystem, and disables service-account token automounting. Writable data is limited to the content volume and a size-bounded /tmp volume. When egress isolation is enabled with an external database, set networkPolicy.egress.externalDatabaseCIDR; the chart rejects an incomplete policy.

Read Security before production deployment and Operations for disruption, backup, restore, and observability guidance.

Troubleshooting

  • If Ghost cannot reach MySQL, verify the database Secret, DNS name, port, and NetworkPolicy database egress.
  • If the pod cannot write content, verify the PVC is writable by UID/GID 1000 and inspect the volume mount events.
  • If a custom listener does not respond, confirm containerPorts.http; the chart reserves server__port so the process and Kubernetes resources cannot diverge.
  • If the S3 job succeeds but posts are missing after recovery, restore MySQL separately; the job archives content only.

Limitations

  • Single instance — Ghost does not support horizontal scaling out of the box
  • MySQL only — Ghost requires MySQL 8; PostgreSQL is not supported. The bundled HelmForge MySQL dependency is kept on MySQL 8 through mysql.image.tag.

Security Scan: ghost

Framework Score
MITRE + NSA + SOC2 89.39%

Security posture acceptable.

More Information

System Architecture

DESIGN.md Synced

Verified architecture contract rendered dynamically from GitHub DESIGN.md

flowchart LR
  user[Reader or editor] --> edge[Ingress or HTTPRoute]
  edge --> svc[Ghost Service]
  svc --> ghost[Ghost Deployment]
  ghost --> content[(Content PVC)]
  ghost --> mysqlSvc[MySQL Service]
  mysqlSvc --> mysql[HelmForge MySQL StatefulSet]
  mysql --> mysqlPvc[(MySQL PVC)]
  secrets[Generated Secrets] --> ghost
  secrets --> mysql
Official Contractvalues.schema.json

Ghost Values Schema Reference

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

159 parametersValues Studio

Global(1)

ParameterTypeDefaultDescription
globalobject-Chart configuration parameter

Name Override(1)

ParameterTypeDefaultDescription
nameOverridestring-Chart configuration parameter

Fullname Override(1)

ParameterTypeDefaultDescription
fullnameOverridestring-Chart configuration parameter

Common Labels(1)

ParameterTypeDefaultDescription
commonLabelsobject-Chart configuration parameter

Common Annotations(1)

ParameterTypeDefaultDescription
commonAnnotationsobject-Chart configuration parameter

Image(3)

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

Image Pull Secrets(1)

ParameterTypeDefaultDescription
imagePullSecretsarray-Chart configuration parameter

Container Ports(1)

ParameterTypeDefaultDescription
containerPorts.httpinteger-Chart configuration parameter

Ghost(2)

ParameterTypeDefaultDescription
ghost.urlstring-Chart configuration parameter
ghost.extraEnvarray-Chart configuration parameter

Database(7)

ParameterTypeDefaultDescription
database.external.hoststring-Chart configuration parameter
database.external.portstringinteger-Chart configuration parameter
database.external.namestring-Chart configuration parameter
database.external.usernamestring-Chart configuration parameter
database.external.passwordstring-Chart configuration parameter
database.external.existingSecretstring-Chart configuration parameter
database.external.existingSecretPasswordKeystring-Chart configuration parameter

Persistence(6)

ParameterTypeDefaultDescription
persistence.enabledboolean-Chart configuration parameter
persistence.sizestring-Chart configuration parameter
persistence.storageClassstring-Chart configuration parameter
persistence.accessModesarray-Chart configuration parameter
persistence.existingClaimstring-Chart configuration parameter
persistence.emptyDirSizeLimitstring-Chart configuration parameter

Backup(30)

ParameterTypeDefaultDescription
backup.enabledboolean-Chart configuration parameter
backup.schedulestring-Chart configuration parameter
backup.suspendboolean-Chart configuration parameter
backup.concurrencyPolicyselect-Chart configuration parameter
Allowed:AllowForbidReplace
backup.successfulJobsHistoryLimitinteger-Chart configuration parameter
backup.failedJobsHistoryLimitinteger-Chart configuration parameter
backup.backoffLimitinteger-Chart configuration parameter
backup.archivePrefixstring-Chart configuration parameter
backup.images.backupstring-Chart configuration parameter
backup.images.uploaderstring-Chart configuration parameter
backup.resources.requests.cpuany-Chart configuration parameter
backup.resources.requests.memoryany-Chart configuration parameter
backup.resources.limits.cpuany-Chart configuration parameter
backup.resources.limits.memoryany-Chart configuration parameter
backup.scratchSizeLimitstring-Chart configuration parameter
backup.serviceAccount.createboolean-Chart configuration parameter
backup.serviceAccount.namestring-Chart configuration parameter
backup.serviceAccount.annotationsobject-Chart configuration parameter
backup.serviceAccount.automountServiceAccountTokenboolean-Chart configuration parameter
backup.s3.endpointstring-Chart configuration parameter
backup.s3.bucketstring-Chart configuration parameter
backup.s3.prefixstring-Chart configuration parameter
backup.s3.regionstring-Chart configuration parameter
backup.s3.credentialsFromPodIdentityboolean-Chart configuration parameter
backup.s3.createBucketIfNotExistsboolean-Chart configuration parameter
backup.s3.existingSecretstring-Chart configuration parameter
backup.s3.existingSecretAccessKeyKeystring-Chart configuration parameter
backup.s3.existingSecretSecretKeyKeystring-Chart configuration parameter
backup.s3.accessKeystring-Chart configuration parameter
backup.s3.secretKeystring-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

Service & Networking(5)

ParameterTypeDefaultDescription
service.typeselect-Chart configuration parameter
Allowed:ClusterIPNodePortLoadBalancer
service.portinteger-Chart configuration parameter
service.annotationsobject-Chart configuration parameter
service.ipFamilyPolicystringnull-Chart configuration parameter
Allowed:nullSingleStackPreferDualStackRequireDualStack
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

Health Probes(18)

ParameterTypeDefaultDescription
probes.startup.enabledboolean-Chart configuration parameter
probes.startup.pathstring-Chart configuration parameter
probes.startup.initialDelaySecondsinteger-Chart configuration parameter
probes.startup.periodSecondsinteger-Chart configuration parameter
probes.startup.timeoutSecondsinteger-Chart configuration parameter
probes.startup.failureThresholdinteger-Chart configuration parameter
probes.liveness.enabledboolean-Chart configuration parameter
probes.liveness.pathstring-Chart configuration parameter
probes.liveness.initialDelaySecondsinteger-Chart configuration parameter
probes.liveness.periodSecondsinteger-Chart configuration parameter
probes.liveness.timeoutSecondsinteger-Chart configuration parameter
probes.liveness.failureThresholdinteger-Chart configuration parameter
probes.readiness.enabledboolean-Chart configuration parameter
probes.readiness.pathstring-Chart configuration parameter
probes.readiness.initialDelaySecondsinteger-Chart configuration parameter
probes.readiness.periodSecondsinteger-Chart configuration parameter
probes.readiness.timeoutSecondsinteger-Chart configuration parameter
probes.readiness.failureThresholdinteger-Chart configuration parameter

Resources(4)

ParameterTypeDefaultDescription
resources.requests.cpuany-Chart configuration parameter
resources.requests.memoryany-Chart configuration parameter
resources.limits.cpuany-Chart configuration parameter
resources.limits.memoryany-Chart configuration parameter

Pod Security(6)

ParameterTypeDefaultDescription
podSecurityContext.runAsNonRootboolean-Chart configuration parameter
podSecurityContext.runAsUserinteger-Chart configuration parameter
podSecurityContext.runAsGroupinteger-Chart configuration parameter
podSecurityContext.fsGroupinteger-Chart configuration parameter
podSecurityContext.fsGroupChangePolicystring-Chart configuration parameter
podSecurityContext.seccompProfile.typestring-Chart configuration parameter

Container Security(4)

ParameterTypeDefaultDescription
securityContext.allowPrivilegeEscalationboolean-Chart configuration parameter
securityContext.privilegedboolean-Chart configuration parameter
securityContext.readOnlyRootFilesystemboolean-Chart configuration parameter
securityContext.capabilities.droparray-Chart configuration parameter

Runtime Storage(1)

ParameterTypeDefaultDescription
runtimeStorage.tmpSizeLimitstring-Chart configuration parameter

Wait For Database(10)

ParameterTypeDefaultDescription
waitForDatabase.securityContext.runAsNonRootboolean-Chart configuration parameter
waitForDatabase.securityContext.runAsUserinteger-Chart configuration parameter
waitForDatabase.securityContext.runAsGroupinteger-Chart configuration parameter
waitForDatabase.securityContext.allowPrivilegeEscalationboolean-Chart configuration parameter
waitForDatabase.securityContext.readOnlyRootFilesystemboolean-Chart configuration parameter
waitForDatabase.securityContext.capabilities.droparray-Chart configuration parameter
waitForDatabase.resources.requests.cpuany-Chart configuration parameter
waitForDatabase.resources.requests.memoryany-Chart configuration parameter
waitForDatabase.resources.limits.cpuany-Chart configuration parameter
waitForDatabase.resources.limits.memoryany-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

Pod Disruption Budget(3)

ParameterTypeDefaultDescription
podDisruptionBudget.enabledboolean-Chart configuration parameter
podDisruptionBudget.minAvailableintegerstringnull-Chart configuration parameter
podDisruptionBudget.maxUnavailableintegerstringnull-Chart configuration parameter

Network Policy(6)

ParameterTypeDefaultDescription
networkPolicy.enabledboolean-Chart configuration parameter
networkPolicy.ingressFromarray-Chart configuration parameter
networkPolicy.egress.enabledboolean-Chart configuration parameter
networkPolicy.egress.allowDNSboolean-Chart configuration parameter
networkPolicy.egress.externalDatabaseCIDRstring-Chart configuration parameter
networkPolicy.egress.extraEgressarray-Chart configuration parameter

Extra Volumes(1)

ParameterTypeDefaultDescription
extraVolumesarray-Chart configuration parameter

Extra Volume Mounts(1)

ParameterTypeDefaultDescription
extraVolumeMountsarray-Chart configuration parameter

Extra Manifests(1)

ParameterTypeDefaultDescription
extraManifestsarray-Chart configuration parameter

Mysql(14)

ParameterTypeDefaultDescription
mysql.enabledboolean-Chart configuration parameter
mysql.image.repositorystring-Chart configuration parameter
mysql.image.tagstring-Chart configuration parameter
mysql.image.pullPolicyselect-Chart configuration parameter
Allowed:AlwaysIfNotPresentNever
mysql.architectureselect-Chart configuration parameter
Allowed:standalonereplication
mysql.auth.databasestring-Chart configuration parameter
mysql.auth.usernamestring-Chart configuration parameter
mysql.auth.passwordstring-Chart configuration parameter
mysql.standalone.persistence.enabledboolean-Chart configuration parameter
mysql.standalone.persistence.sizestring-Chart configuration parameter
mysql.standalone.resources.requests.cpuany-Chart configuration parameter
mysql.standalone.resources.requests.memoryany-Chart configuration parameter
mysql.standalone.resources.limits.cpuany-Chart configuration parameter
mysql.standalone.resources.limits.memoryany-Chart configuration parameter

Gateway(6)

ParameterTypeDefaultDescription
gateway.enabledboolean-Chart configuration parameter
gateway.annotationsobject-Chart configuration parameter
gateway.parentRefsarray-Chart configuration parameter
gateway.hostnamesarray-Chart configuration parameter
gateway.pathstring-Chart configuration parameter
gateway.pathTypeselect-Chart configuration parameter
Allowed:PathPrefixExactRegularExpression

External Secrets(7)

ParameterTypeDefaultDescription
externalSecrets.enabledboolean-Chart configuration parameter
externalSecrets.apiVersionselect-Chart configuration parameter
Allowed:external-secrets.io/v1external-secrets.io/v1beta1
externalSecrets.refreshIntervalstring-Chart configuration parameter
externalSecrets.itemsarray-Chart configuration parameter
externalSecrets.secretStoreRefobject-Chart configuration parameter
externalSecrets.targetobject-Chart configuration parameter
externalSecrets.dataarray-Chart configuration parameter