Skip to content
Strapi icon
v2.3.21App: v5.61.0Pinned DigestS3 Backup Ready

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

Strapi Helm Chart

Deploy Strapi on Kubernetes as a headless CMS for APIs, websites, and custom admin experiences.

This chart is designed for a prebuilt Strapi project image. It does not build application source code inside the cluster.

Features

  • Production-ready base image — HelmForge's optimized Strapi image with all plugins included
  • SQLite by default for simple environments
  • PostgreSQL subchart bundled via HelmForge dependency
  • MySQL subchart bundled via HelmForge dependency
  • External database support for existing PostgreSQL or MySQL
  • Application secrets auto-generated and preserved across upgrades
  • Uploads persistence using a single PVC with dedicated subpaths
  • Scheduled backups for SQLite or database dump workflows with S3 upload
  • Ingress support with ingressClassName and TLS

HelmForge Base Image

This chart uses the official HelmForge Strapi base image (docker.io/helmforge/strapi-base:5.61.0) which provides:

  • Strapi 5.61.0 with all official plugins pre-installed
  • Multi-database support — SQLite, PostgreSQL, MySQL ready to use
  • Health check endpoint — HTTP health checks on /_health for proper Kubernetes integration
  • Security hardened — Non-root user (UID 1000), minimal attack surface
  • Multi-architecture — Supports both amd64 and arm64 platforms
  • Production optimized — Pre-built with best practices for Kubernetes deployments

You can use this base image directly for testing or extend it with your own Strapi project configuration.

Installation

HTTPS repository:

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

OCI registry:

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

Basic Example (SQLite)

# values.yaml
image:
  repository: ghcr.io/example/my-strapi
  tag: "1.0.0"

persistence:
  enabled: true
  size: 5Gi

PostgreSQL Example

image:
  repository: ghcr.io/example/my-strapi
  tag: "1.0.0"

postgresql:
  enabled: true
  auth:
    database: strapi
    username: strapi
    password: "strong-password"

ingress:
  enabled: true
  ingressClassName: traefik
  hosts:
    - host: cms.example.com
      paths:
        - path: /
          pathType: Prefix
  tls:
    - secretName: strapi-tls
      hosts:
        - cms.example.com

External Database Example

image:
  repository: ghcr.io/example/my-strapi
  tag: "1.0.0"

database:
  external:
    vendor: postgres
    host: db.example.com
    name: strapi
    username: strapi
    existingSecret: strapi-db-credentials
Official Schema

Values & Configuration Reference

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

View Values Schema

|-----|---------|-------------| | image.repository | helmforge/strapi-base | Container image for the Strapi project | | image.tag | 5.61.0 | HelmForge Strapi base image version | | strapi.url | "" | Public URL (auto-detected from ingress if empty) | | strapi.port | 1337 | Container port | | strapi.telemetryDisabled | true | Disable telemetry | | database.mode | auto | Database mode (auto, sqlite, external, postgresql, mysql) | | database.sqlite.directory | /opt/app/.tmp | SQLite directory | | database.sqlite.filename | data.db | SQLite filename | | database.external.vendor | postgres | External DB vendor (postgres, mysql) | | database.external.host | "" | External DB host | | postgresql.enabled | true | Deploy PostgreSQL subchart | | mysql.enabled | false | Deploy MySQL subchart | | persistence.enabled | true | Enable uploads and SQLite persistence | | persistence.size | 5Gi | PVC size | | ingress.enabled | false | Enable ingress | | backup.enabled | false | Enable S3 backups | | secrets.existingSecret | "" | Use an existing secret for Strapi app secrets |

Resources Generated

Resource Condition
Deployment Always
Service Always
Secret (app) secrets.existingSecret is empty
Secret (database) Database mode is not sqlite and no existing secret
Secret (backup) backup.enabled and no backup.s3.existingSecret
PVC persistence.enabled and no persistence.existingClaim
Ingress ingress.enabled
ServiceAccount serviceAccount.create
CronJob (backup) backup.enabled
ConfigMap (backup scripts) backup.enabled

Notes

  • The default image is helmforge/strapi-base:5.61.0, HelmForge's production-ready Strapi image. Override it if your deployment uses a custom Strapi build.
  • SQLite is supported for simple deployments, but server-based databases are recommended for production workloads.
  • Horizontal scaling is intentionally out of scope for this v1 chart because default local uploads persistence is single-writer oriented.
  • For ingress, set ingress.ingressClassName to the class used in your cluster, such as traefik, nginx, or another supported controller.

Upgrade Notes

Strapi 5.61.0 requires Node.js 22.19 or later; the HelmForge base image uses Node.js 22.23.4. The upgrade also includes Knex 3.3.0. Custom application code that calls delete() with limit or having, or truncate() with where, having, or limit, must follow the updated database-driver behavior.

Back up the database and uploads PVC before upgrading production workloads. Review custom upload configuration as sharp.limitInputPixels must be a number or boolean rather than a raw environment-variable string.

For standalone MySQL, use mysql.standalone.persistence. For replication, use mysql.replication.source.persistence and mysql.replication.readReplicas.persistence. The former mysql.primary.persistence parent value was not consumed by the HelmForge MySQL subchart.

Existing standalone releases therefore used the MySQL chart's effective claim template, normally 8Gi, even if a different size was set under mysql.primary.persistence. During the chart upgrade, keep mysql.standalone.persistence.size equal to that existing claim-template size; copying the intended size directly can make Kubernetes reject the immutable StatefulSet update. Resize or migrate the bound PVC separately according to the storage class, and only change the claim template through a planned StatefulSet recreation. Before recreating it, back up the database, set the existing StatefulSet's mysql.standalone.persistence.retentionPolicy.whenDeleted to Retain, and confirm that the StatefulSet owner reference has been removed from the PVC. Restore the desired retention policy after recreation if needed.

More Information

Security Scan: strapi

Framework Score
MITRE + NSA + SOC2 87.57576%

Security posture acceptable.

System Architecture

DESIGN.md Synced

Verified architecture contract rendered dynamically from GitHub DESIGN.md

flowchart TB
  users[Users] --> route[Ingress or Service]
  route --> app[Strapi Deployment]
  app --> uploads[(Uploads PVC)]
  app --> sqlite[(SQLite PVC)]
  app --> pg[(PostgreSQL)]
  app --> mysql[(MySQL)]
  app --> extdb[(External database)]
  eso[External Secrets Operator] -. optional .-> secrets[Application and database Secrets]
  secrets --> app
  backup[Backup CronJob] --> s3[S3-compatible storage]
Official Contractvalues.schema.json

Strapi Values Schema Reference

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

215 parametersValues Studio

Global(1)

ParameterTypeDefaultDescription
globalobject-Global settings shared by the chart.

Name Override(1)

ParameterTypeDefaultDescription
nameOverridestring-Override the chart name used in resource names.

Fullname Override(1)

ParameterTypeDefaultDescription
fullnameOverridestring-Override the full release name used in resource names.

Common Labels(1)

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

Replica Count(1)

ParameterTypeDefaultDescription
replicaCountinteger-Number of replicas. Multi-replica requires S3/Cloudinary upload provider.

Image(3)

ParameterTypeDefaultDescription
image.repositorystring-Container image repository for your Strapi project.
image.tagstring-Container image tag (defaults to appVersion when empty).
image.pullPolicystring-Image pull policy.
Allowed:AlwaysIfNotPresentNever

Image Pull Secrets(1)

ParameterTypeDefaultDescription
imagePullSecretsarray-Image pull secrets for private registries.

Strapi(69)

ParameterTypeDefaultDescription
strapi.hoststring-Host interface.
strapi.portinteger-Container port exposed by Strapi.
strapi.urlstring-Public URL of the Strapi instance (auto-detected from ingress if empty).
strapi.nodeEnvstring-Node environment.
Allowed:productiondevelopment
strapi.telemetryDisabledboolean-Disable telemetry.
strapi.commandarray-Start command override.
strapi.argsarray-Start arguments override.
strapi.extraEnvarray-Additional environment variables for the Strapi container.
strapi.upload.providerstring-Chart configuration parameter
Allowed:localaws-s3cloudinary
strapi.upload.s3.enabledboolean-Chart configuration parameter
strapi.upload.s3.endpointstring-Chart configuration parameter
strapi.upload.s3.regionstring-Chart configuration parameter
strapi.upload.s3.bucketstring-Chart configuration parameter
strapi.upload.s3.prefixstring-Chart configuration parameter
strapi.upload.s3.existingSecretstring-Chart configuration parameter
strapi.upload.s3.existingSecretAccessKeyKeystring-Chart configuration parameter
strapi.upload.s3.existingSecretSecretKeyKeystring-Chart configuration parameter
strapi.upload.s3.accessKeystring-Chart configuration parameter
strapi.upload.s3.secretKeystring-Chart configuration parameter
strapi.upload.s3.aclstring-Chart configuration parameter
strapi.upload.s3.baseUrlstring-Chart configuration parameter
strapi.upload.s3.paramsobject-Chart configuration parameter
strapi.upload.cloudinary.enabledboolean-Chart configuration parameter
strapi.upload.cloudinary.cloudNamestring-Chart configuration parameter
strapi.upload.cloudinary.apiKeystring-Chart configuration parameter
strapi.upload.cloudinary.apiSecretstring-Chart configuration parameter
strapi.upload.cloudinary.existingSecretstring-Chart configuration parameter
strapi.upload.cloudinary.existingSecretApiKeyKeystring-Chart configuration parameter
strapi.upload.cloudinary.existingSecretApiSecretKeystring-Chart configuration parameter
strapi.performance.nodeOptionsstring-Chart configuration parameter
strapi.performance.logLevelstring-Chart configuration parameter
Allowed:fatalerrorwarninfodebugtrace
strapi.performance.prettyPrintboolean-Chart configuration parameter
strapi.performance.forceJsonLogsboolean-Chart configuration parameter
strapi.admin.pathstring-Chart configuration parameter
strapi.admin.autoOpenboolean-Chart configuration parameter
strapi.admin.jwtExpirationstring-Chart configuration parameter
strapi.admin.rateLimit.enabledboolean-Chart configuration parameter
strapi.admin.rateLimit.maxinteger-Chart configuration parameter
strapi.admin.rateLimit.timeWindowinteger-Chart configuration parameter
strapi.admin.forgotPassword.enabledboolean-Chart configuration parameter
strapi.email.providerstring-Chart configuration parameter
Allowed:nonesmtpsendgrid
strapi.email.defaultFromstring-Chart configuration parameter
strapi.email.defaultReplyTostring-Chart configuration parameter
strapi.email.smtp.hoststring-Chart configuration parameter
strapi.email.smtp.portinteger-Chart configuration parameter
strapi.email.smtp.usernamestring-Chart configuration parameter
strapi.email.smtp.passwordstring-Chart configuration parameter
strapi.email.smtp.existingSecretstring-Chart configuration parameter
strapi.email.smtp.existingSecretPasswordKeystring-Chart configuration parameter
strapi.email.smtp.secureboolean-Chart configuration parameter
strapi.email.smtp.requireTLSboolean-Chart configuration parameter
strapi.email.smtp.ignoreTLSboolean-Chart configuration parameter
strapi.email.sendgrid.apiKeystring-Chart configuration parameter
strapi.email.sendgrid.existingSecretstring-Chart configuration parameter
strapi.email.sendgrid.existingSecretApiKeyKeystring-Chart configuration parameter
strapi.graphql.playgroundEnabledboolean-Chart configuration parameter
strapi.graphql.endpointstring-Chart configuration parameter
strapi.graphql.introspectionboolean-Chart configuration parameter
strapi.graphql.maxDepthinteger-Chart configuration parameter
strapi.graphql.maxComplexityinteger-Chart configuration parameter
strapi.graphql.apolloSandboxboolean-Chart configuration parameter
strapi.api.rest.defaultLimitinteger-Chart configuration parameter
strapi.api.rest.maxLimitinteger-Chart configuration parameter
strapi.server.bodyParser.jsonLimitstring-Chart configuration parameter
strapi.server.bodyParser.formLimitstring-Chart configuration parameter
strapi.server.bodyParser.textLimitstring-Chart configuration parameter
strapi.server.compression.enabledboolean-Chart configuration parameter
strapi.server.cron.enabledboolean-Chart configuration parameter
strapi.server.logger.levelstring-Chart configuration parameter

Secrets(11)

ParameterTypeDefaultDescription
secrets.existingSecretstring-Use an existing secret containing all Strapi app secrets.
secrets.existingSecretAppKeysKeystring-Existing secret key for APP_KEYS (comma-separated).
secrets.existingSecretApiTokenSaltKeystring-Existing secret key for API token salt.
secrets.existingSecretAdminJwtSecretKeystring-Existing secret key for admin JWT secret.
secrets.existingSecretJwtSecretKeystring-Existing secret key for application JWT secret.
secrets.existingSecretTransferTokenSaltKeystring-Existing secret key for transfer token salt.
secrets.appKeysstring-Explicit APP_KEYS value (comma-separated). Auto-generated if empty.
secrets.apiTokenSaltstring-Explicit API token salt. Auto-generated if empty.
secrets.adminJwtSecretstring-Explicit admin JWT secret. Auto-generated if empty.
secrets.jwtSecretstring-Explicit application JWT secret. Auto-generated if empty.
secrets.transferTokenSaltstring-Explicit transfer token salt. Auto-generated if empty.

Database(16)

ParameterTypeDefaultDescription
database.modestring-Database mode: auto | sqlite | external | postgresql | mysql.
Allowed:autosqliteexternalpostgresqlmysql
database.sqlite.directorystring-Directory mounted for the SQLite database file.
database.sqlite.filenamestring-SQLite database filename.
database.external.vendorstring-External database vendor: postgres | mysql.
Allowed:postgresmysql
database.external.hoststring-External database hostname.
database.external.portstringinteger-External database port (auto-detected from vendor if empty).
database.external.namestring-Database name.
database.external.usernamestring-Database username.
database.external.passwordstring-Database password (ignored when existingSecret is set).
database.external.existingSecretstring-Existing secret for the database password.
database.external.existingSecretPasswordKeystring-Key in the existing secret for the database password.
database.external.ssl.enabledboolean-Set DATABASE_SSL=true.
database.pool.mininteger-Minimum database connections per replica.
database.pool.maxinteger-Maximum database connections per replica.
database.pool.acquireTimeoutMillisinteger-Connection acquisition timeout (ms).
database.pool.idleTimeoutMillisinteger-Idle connection timeout (ms).

Postgresql(8)

ParameterTypeDefaultDescription
postgresql.enabledboolean-Deploy PostgreSQL as a subchart.
postgresql.architecturestring-PostgreSQL architecture (standalone or replication).
postgresql.auth.databasestring-Database name created on first run.
postgresql.auth.usernamestring-Database username created on first run.
postgresql.auth.passwordstring-Database password (auto-generated if empty).
postgresql.auth.rootPasswordstring-Root password (auto-generated if empty).
postgresql.primary.persistence.enabledboolean-Enable persistence for PostgreSQL data.
postgresql.primary.persistence.sizestring-PVC size for PostgreSQL.

Mysql(8)

ParameterTypeDefaultDescription
mysql.enabledboolean-Deploy MySQL as a subchart.
mysql.architecturestring-MySQL architecture (standalone or replication).
mysql.auth.databasestring-Database name created on first run.
mysql.auth.usernamestring-Database username created on first run.
mysql.auth.passwordstring-Database password (auto-generated if empty).
mysql.auth.rootPasswordstring-Root password (auto-generated if empty).
mysql.standalone.persistence.enabledboolean-Enable persistence for MySQL data.
mysql.standalone.persistence.sizestring-PVC size for MySQL.

Persistence(9)

ParameterTypeDefaultDescription
persistence.enabledboolean-Enable persistent storage for uploads and SQLite data.
persistence.storageClassstring-Storage class (leave empty for cluster default).
persistence.accessModestring-Access mode for the PVC.
persistence.sizestring-Size of the persistent volume.
persistence.existingClaimstring-Use an existing PVC instead of creating one.
persistence.annotationsobject-Annotations for the PVC.
persistence.uploads.mountPathstring-Uploads directory inside the Strapi container.
persistence.uploads.subPathstring-PVC subPath used for uploads data.
persistence.sqlite.subPathstring-PVC subPath used for SQLite data.

Resources(1)

ParameterTypeDefaultDescription
resourcesobject-CPU and memory requests/limits for the Strapi container.

Pod Security(4)

ParameterTypeDefaultDescription
podSecurityContext.fsGroupinteger-Chart configuration parameter
podSecurityContext.fsGroupChangePolicystring-Chart configuration parameter
Allowed:AlwaysOnRootMismatch
podSecurityContext.seccompProfile.typestring-Chart configuration parameter
Allowed:RuntimeDefaultUnconfinedLocalhost
podSecurityContext.seccompProfile.localhostProfilestring-Chart configuration parameter

Container Security(6)

ParameterTypeDefaultDescription
securityContext.runAsNonRootboolean-Chart configuration parameter
securityContext.runAsUserinteger-Chart configuration parameter
securityContext.runAsGroupinteger-Chart configuration parameter
securityContext.allowPrivilegeEscalationboolean-Chart configuration parameter
securityContext.capabilities.droparray-Chart configuration parameter
securityContext.capabilities.addarray-Chart configuration parameter

Automount Service Account Token(1)

ParameterTypeDefaultDescription
automountServiceAccountTokenboolean-Mount the ServiceAccount token (Strapi does not call the Kubernetes API).

Startup Probe(5)

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

Liveness Probe(5)

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

Readiness Probe(5)

ParameterTypeDefaultDescription
readinessProbe.enabledboolean-Enable readiness probe.
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-Service type.
Allowed:ClusterIPNodePortLoadBalancer
service.portinteger-HTTP port exposed by the Service.
service.ipFamilyPolicystring-Dual-stack ipFamilyPolicy.
service.ipFamiliesarray-Dual-stack ipFamilies.
service.annotationsobject-Annotations for the service.

Ingress(5)

ParameterTypeDefaultDescription
ingress.enabledboolean-Enable ingress for Strapi.
ingress.ingressClassNamestring-Ingress class name.
ingress.annotationsobject-Ingress annotations.
ingress.hostsarray-Ingress hosts.
ingress.tlsarray-Ingress TLS configuration.

Service Account(3)

ParameterTypeDefaultDescription
serviceAccount.createboolean-Create a dedicated ServiceAccount.
serviceAccount.namestring-Name override (auto-generated if empty).
serviceAccount.annotationsobject-Annotations for the ServiceAccount.

Backup(30)

ParameterTypeDefaultDescription
backup.enabledboolean-Enable scheduled backups to S3-compatible storage.
backup.schedulestring-Cron schedule for backups (default: daily at 03:00 UTC).
backup.suspendboolean-Suspend the CronJob without deleting it.
backup.concurrencyPolicystring-Concurrency policy: Forbid, Replace, Allow.
Allowed:ForbidReplaceAllow
backup.successfulJobsHistoryLimitinteger-Number of successful job records to keep.
backup.failedJobsHistoryLimitinteger-Number of failed job records to keep.
backup.backoffLimitinteger-Maximum retries per backup job.
backup.archivePrefixstring-Prefix for backup archive filenames.
backup.images.utilitystring-Image used for local file backup jobs (must have tar).
backup.images.postgresqlstring-Image used for PostgreSQL backup (must have pg_dump).
backup.images.mysqlstring-Image used for MySQL backup (must have mysqldump).
backup.images.uploaderstring-Image used for S3 upload (MinIO client).
backup.resourcesobject-Resources for backup containers.
backup.s3.endpointstring-S3-compatible endpoint URL.
backup.s3.bucketstring-Target bucket name.
backup.s3.prefixstring-Key prefix within the bucket.
backup.s3.createBucketIfNotExistsboolean-Auto-create the bucket if it does not exist.
backup.s3.existingSecretstring-Use an existing secret for S3 credentials.
backup.s3.existingSecretAccessKeyKeystring-Key in the existing secret for the access key.
backup.s3.existingSecretSecretKeyKeystring-Key in the existing secret for the secret key.
backup.s3.accessKeystring-Inline S3 access key (ignored when existingSecret is set).
backup.s3.secretKeystring-Inline S3 secret key (ignored when existingSecret is set).
backup.database.hoststring-Override database host for backup.
backup.database.portstringinteger-Override database port for backup.
backup.database.namestring-Override database name for backup.
backup.database.usernamestring-Override database username for backup.
backup.database.existingSecretstring-Existing secret for backup database credentials.
backup.database.existingSecretPasswordKeystring-Key in existing secret for the backup database password.
backup.database.postgresDumpArgsstring-Extra arguments for pg_dump.
backup.database.mysqlDumpArgsstring-Extra arguments for mysqldump.

Node Selector(1)

ParameterTypeDefaultDescription
nodeSelectorobject-Node selector for pod scheduling.

Tolerations(1)

ParameterTypeDefaultDescription
tolerationsarray-Tolerations for pod scheduling.

Affinity(1)

ParameterTypeDefaultDescription
affinityobject-Affinity rules for pod scheduling.

Topology Spread Constraints(1)

ParameterTypeDefaultDescription
topologySpreadConstraintsarray-Topology spread constraints.

Priority Class Name(1)

ParameterTypeDefaultDescription
priorityClassNamestring-Priority class name.

Termination Grace Period Seconds(1)

ParameterTypeDefaultDescription
terminationGracePeriodSecondsinteger-Grace period for shutdown (seconds).

Pod Labels(1)

ParameterTypeDefaultDescription
podLabelsobject-Additional labels for the pod.

Pod Annotations(1)

ParameterTypeDefaultDescription
podAnnotationsobject-Additional annotations for the pod.

Extra Volume Mounts(1)

ParameterTypeDefaultDescription
extraVolumeMountsarray-Additional volume mounts for the Strapi container.

Extra Volumes(1)

ParameterTypeDefaultDescription
extraVolumesarray-Additional volumes for the pod.

Extra Manifests(1)

ParameterTypeDefaultDescription
extraManifestsarray-Extra Kubernetes manifests to deploy alongside the chart.

Gateway Api(2)

ParameterTypeDefaultDescription
gatewayApi.enabledboolean-Chart configuration parameter
gatewayApi.httpRoutesarray-Chart configuration parameter

External Secrets(2)

ParameterTypeDefaultDescription
externalSecrets.enabledboolean-Chart configuration parameter
externalSecrets.itemsarray-Chart configuration parameter