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.httpupdates 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.
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.
|-----|---------|-------------|
| 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 reservesserver__portso 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 SyncedVerified 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
Ghost Values Schema Reference
Official schema parameters, default values, and types extracted directly from the chart repository.
Global(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| global | object | - | Chart configuration parameter |
Name Override(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| nameOverride | string | - | Chart configuration parameter |
Fullname Override(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| fullnameOverride | string | - | Chart configuration parameter |
Common Labels(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| commonLabels | object | - | Chart configuration parameter |
Common Annotations(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| commonAnnotations | object | - | Chart configuration parameter |
Image(3)
| Parameter | Type | Default | Description |
|---|---|---|---|
| image.repository | string | - | Chart configuration parameter |
| image.tag | string | - | Chart configuration parameter |
| image.pullPolicy | select | - | Chart configuration parameter Allowed: AlwaysIfNotPresentNever |
Image Pull Secrets(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| imagePullSecrets | array | - | Chart configuration parameter |
Container Ports(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| containerPorts.http | integer | - | Chart configuration parameter |
Ghost(2)
| Parameter | Type | Default | Description |
|---|---|---|---|
| ghost.url | string | - | Chart configuration parameter |
| ghost.extraEnv | array | - | Chart configuration parameter |
Database(7)
| Parameter | Type | Default | Description |
|---|---|---|---|
| database.external.host | string | - | Chart configuration parameter |
| database.external.port | stringinteger | - | Chart configuration parameter |
| database.external.name | string | - | Chart configuration parameter |
| database.external.username | string | - | Chart configuration parameter |
| database.external.password | string | - | Chart configuration parameter |
| database.external.existingSecret | string | - | Chart configuration parameter |
| database.external.existingSecretPasswordKey | string | - | Chart configuration parameter |
Persistence(6)
| Parameter | Type | Default | Description |
|---|---|---|---|
| persistence.enabled | boolean | - | Chart configuration parameter |
| persistence.size | string | - | Chart configuration parameter |
| persistence.storageClass | string | - | Chart configuration parameter |
| persistence.accessModes | array | - | Chart configuration parameter |
| persistence.existingClaim | string | - | Chart configuration parameter |
| persistence.emptyDirSizeLimit | string | - | Chart configuration parameter |
Backup(30)
| Parameter | Type | Default | Description |
|---|---|---|---|
| backup.enabled | boolean | - | Chart configuration parameter |
| backup.schedule | string | - | Chart configuration parameter |
| backup.suspend | boolean | - | Chart configuration parameter |
| backup.concurrencyPolicy | select | - | Chart configuration parameter Allowed: AllowForbidReplace |
| backup.successfulJobsHistoryLimit | integer | - | Chart configuration parameter |
| backup.failedJobsHistoryLimit | integer | - | Chart configuration parameter |
| backup.backoffLimit | integer | - | Chart configuration parameter |
| backup.archivePrefix | string | - | Chart configuration parameter |
| backup.images.backup | string | - | Chart configuration parameter |
| backup.images.uploader | string | - | Chart configuration parameter |
| backup.resources.requests.cpu | any | - | Chart configuration parameter |
| backup.resources.requests.memory | any | - | Chart configuration parameter |
| backup.resources.limits.cpu | any | - | Chart configuration parameter |
| backup.resources.limits.memory | any | - | Chart configuration parameter |
| backup.scratchSizeLimit | string | - | Chart configuration parameter |
| backup.serviceAccount.create | boolean | - | Chart configuration parameter |
| backup.serviceAccount.name | string | - | Chart configuration parameter |
| backup.serviceAccount.annotations | object | - | Chart configuration parameter |
| backup.serviceAccount.automountServiceAccountToken | boolean | - | Chart configuration parameter |
| backup.s3.endpoint | string | - | Chart configuration parameter |
| backup.s3.bucket | string | - | Chart configuration parameter |
| backup.s3.prefix | string | - | Chart configuration parameter |
| backup.s3.region | string | - | Chart configuration parameter |
| backup.s3.credentialsFromPodIdentity | boolean | - | Chart configuration parameter |
| backup.s3.createBucketIfNotExists | boolean | - | Chart configuration parameter |
| backup.s3.existingSecret | string | - | Chart configuration parameter |
| backup.s3.existingSecretAccessKeyKey | string | - | Chart configuration parameter |
| backup.s3.existingSecretSecretKeyKey | string | - | Chart configuration parameter |
| backup.s3.accessKey | string | - | Chart configuration parameter |
| backup.s3.secretKey | string | - | Chart configuration parameter |
Service Account(4)
| Parameter | Type | Default | Description |
|---|---|---|---|
| serviceAccount.create | boolean | - | Chart configuration parameter |
| serviceAccount.name | string | - | Chart configuration parameter |
| serviceAccount.annotations | object | - | Chart configuration parameter |
| serviceAccount.automountServiceAccountToken | boolean | - | Chart configuration parameter |
Service & Networking(5)
| Parameter | Type | Default | Description |
|---|---|---|---|
| service.type | select | - | Chart configuration parameter Allowed: ClusterIPNodePortLoadBalancer |
| service.port | integer | - | Chart configuration parameter |
| service.annotations | object | - | Chart configuration parameter |
| service.ipFamilyPolicy | stringnull | - | Chart configuration parameter Allowed: nullSingleStackPreferDualStackRequireDualStack |
| service.ipFamilies | array | - | Chart configuration parameter |
Ingress(5)
| Parameter | Type | Default | Description |
|---|---|---|---|
| ingress.enabled | boolean | - | Chart configuration parameter |
| ingress.ingressClassName | string | - | Chart configuration parameter |
| ingress.annotations | object | - | Chart configuration parameter |
| ingress.hosts | array | - | Chart configuration parameter |
| ingress.tls | array | - | Chart configuration parameter |
Health Probes(18)
| Parameter | Type | Default | Description |
|---|---|---|---|
| probes.startup.enabled | boolean | - | Chart configuration parameter |
| probes.startup.path | string | - | Chart configuration parameter |
| probes.startup.initialDelaySeconds | integer | - | Chart configuration parameter |
| probes.startup.periodSeconds | integer | - | Chart configuration parameter |
| probes.startup.timeoutSeconds | integer | - | Chart configuration parameter |
| probes.startup.failureThreshold | integer | - | Chart configuration parameter |
| probes.liveness.enabled | boolean | - | Chart configuration parameter |
| probes.liveness.path | string | - | Chart configuration parameter |
| probes.liveness.initialDelaySeconds | integer | - | Chart configuration parameter |
| probes.liveness.periodSeconds | integer | - | Chart configuration parameter |
| probes.liveness.timeoutSeconds | integer | - | Chart configuration parameter |
| probes.liveness.failureThreshold | integer | - | Chart configuration parameter |
| probes.readiness.enabled | boolean | - | Chart configuration parameter |
| probes.readiness.path | string | - | Chart configuration parameter |
| probes.readiness.initialDelaySeconds | integer | - | Chart configuration parameter |
| probes.readiness.periodSeconds | integer | - | Chart configuration parameter |
| probes.readiness.timeoutSeconds | integer | - | Chart configuration parameter |
| probes.readiness.failureThreshold | integer | - | Chart configuration parameter |
Resources(4)
| Parameter | Type | Default | Description |
|---|---|---|---|
| resources.requests.cpu | any | - | Chart configuration parameter |
| resources.requests.memory | any | - | Chart configuration parameter |
| resources.limits.cpu | any | - | Chart configuration parameter |
| resources.limits.memory | any | - | Chart configuration parameter |
Pod Security(6)
| Parameter | Type | Default | Description |
|---|---|---|---|
| podSecurityContext.runAsNonRoot | boolean | - | Chart configuration parameter |
| podSecurityContext.runAsUser | integer | - | Chart configuration parameter |
| podSecurityContext.runAsGroup | integer | - | Chart configuration parameter |
| podSecurityContext.fsGroup | integer | - | Chart configuration parameter |
| podSecurityContext.fsGroupChangePolicy | string | - | Chart configuration parameter |
| podSecurityContext.seccompProfile.type | string | - | Chart configuration parameter |
Container Security(4)
| Parameter | Type | Default | Description |
|---|---|---|---|
| securityContext.allowPrivilegeEscalation | boolean | - | Chart configuration parameter |
| securityContext.privileged | boolean | - | Chart configuration parameter |
| securityContext.readOnlyRootFilesystem | boolean | - | Chart configuration parameter |
| securityContext.capabilities.drop | array | - | Chart configuration parameter |
Runtime Storage(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| runtimeStorage.tmpSizeLimit | string | - | Chart configuration parameter |
Wait For Database(10)
| Parameter | Type | Default | Description |
|---|---|---|---|
| waitForDatabase.securityContext.runAsNonRoot | boolean | - | Chart configuration parameter |
| waitForDatabase.securityContext.runAsUser | integer | - | Chart configuration parameter |
| waitForDatabase.securityContext.runAsGroup | integer | - | Chart configuration parameter |
| waitForDatabase.securityContext.allowPrivilegeEscalation | boolean | - | Chart configuration parameter |
| waitForDatabase.securityContext.readOnlyRootFilesystem | boolean | - | Chart configuration parameter |
| waitForDatabase.securityContext.capabilities.drop | array | - | Chart configuration parameter |
| waitForDatabase.resources.requests.cpu | any | - | Chart configuration parameter |
| waitForDatabase.resources.requests.memory | any | - | Chart configuration parameter |
| waitForDatabase.resources.limits.cpu | any | - | Chart configuration parameter |
| waitForDatabase.resources.limits.memory | any | - | Chart configuration parameter |
Node Selector(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| nodeSelector | object | - | Chart configuration parameter |
Tolerations(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| tolerations | array | - | Chart configuration parameter |
Affinity(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| affinity | object | - | Chart configuration parameter |
Topology Spread Constraints(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| topologySpreadConstraints | array | - | Chart configuration parameter |
Priority Class Name(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| priorityClassName | string | - | Chart configuration parameter |
Termination Grace Period Seconds(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| terminationGracePeriodSeconds | integer | - | Chart configuration parameter |
Pod Labels(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| podLabels | object | - | Chart configuration parameter |
Pod Annotations(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| podAnnotations | object | - | Chart configuration parameter |
Pod Disruption Budget(3)
| Parameter | Type | Default | Description |
|---|---|---|---|
| podDisruptionBudget.enabled | boolean | - | Chart configuration parameter |
| podDisruptionBudget.minAvailable | integerstringnull | - | Chart configuration parameter |
| podDisruptionBudget.maxUnavailable | integerstringnull | - | Chart configuration parameter |
Network Policy(6)
| Parameter | Type | Default | Description |
|---|---|---|---|
| networkPolicy.enabled | boolean | - | Chart configuration parameter |
| networkPolicy.ingressFrom | array | - | Chart configuration parameter |
| networkPolicy.egress.enabled | boolean | - | Chart configuration parameter |
| networkPolicy.egress.allowDNS | boolean | - | Chart configuration parameter |
| networkPolicy.egress.externalDatabaseCIDR | string | - | Chart configuration parameter |
| networkPolicy.egress.extraEgress | array | - | Chart configuration parameter |
Extra Volumes(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| extraVolumes | array | - | Chart configuration parameter |
Extra Volume Mounts(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| extraVolumeMounts | array | - | Chart configuration parameter |
Extra Manifests(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| extraManifests | array | - | Chart configuration parameter |
Mysql(14)
| Parameter | Type | Default | Description |
|---|---|---|---|
| mysql.enabled | boolean | - | Chart configuration parameter |
| mysql.image.repository | string | - | Chart configuration parameter |
| mysql.image.tag | string | - | Chart configuration parameter |
| mysql.image.pullPolicy | select | - | Chart configuration parameter Allowed: AlwaysIfNotPresentNever |
| mysql.architecture | select | - | Chart configuration parameter Allowed: standalonereplication |
| mysql.auth.database | string | - | Chart configuration parameter |
| mysql.auth.username | string | - | Chart configuration parameter |
| mysql.auth.password | string | - | Chart configuration parameter |
| mysql.standalone.persistence.enabled | boolean | - | Chart configuration parameter |
| mysql.standalone.persistence.size | string | - | Chart configuration parameter |
| mysql.standalone.resources.requests.cpu | any | - | Chart configuration parameter |
| mysql.standalone.resources.requests.memory | any | - | Chart configuration parameter |
| mysql.standalone.resources.limits.cpu | any | - | Chart configuration parameter |
| mysql.standalone.resources.limits.memory | any | - | Chart configuration parameter |
Gateway(6)
| Parameter | Type | Default | Description |
|---|---|---|---|
| gateway.enabled | boolean | - | 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 | select | - | Chart configuration parameter Allowed: PathPrefixExactRegularExpression |
External Secrets(7)
| Parameter | Type | Default | Description |
|---|---|---|---|
| externalSecrets.enabled | boolean | - | Chart configuration parameter |
| externalSecrets.apiVersion | select | - | Chart configuration parameter Allowed: external-secrets.io/v1external-secrets.io/v1beta1 |
| externalSecrets.refreshInterval | string | - | Chart configuration parameter |
| externalSecrets.items | array | - | Chart configuration parameter |
| externalSecrets.secretStoreRef | object | - | Chart configuration parameter |
| externalSecrets.target | object | - | 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.