Skip to content
Superset icon
v1.4.5App: v6.1.0Pinned DigestS3 Backup Ready

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

Apache Superset

Apache Superset is a modern, enterprise-ready business intelligence web application for data exploration and visualization. It supports 60+ database connectors, interactive dashboards, SQL Lab, and a rich set of visualizations.

Features

  • Three-component architecture — web server (Gunicorn), Celery worker, and Celery beat scheduler as separate Deployments for independent scaling
  • Managed init Job — ordered database migration, Superset initialization, and administrator creation on every release revision
  • PostgreSQL subchart — bundled metadata store with option for external database
  • Redis subchart — bundled Celery broker and result backend with option for external Redis
  • superset_config.py via ConfigMap — extend Superset configuration through superset.extraConfig
  • Additional Python packages — install pinned database drivers consistently in web, worker, beat, and init
  • Auto-generated secrets — admin password, Flask SECRET_KEY, database and Redis passwords
  • Health probes — startup, liveness, and readiness probes on /health
  • Hardened runtime — non-root containers, read-only root filesystem, seccomp, dropped capabilities, and scoped wait RBAC
  • NetworkPolicy — web-listener ingress isolation with configurable egress
  • Ingress support — configurable with ingressClassName (traefik, nginx, etc.)

Install

Helm repository

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

OCI registry

helm install superset oci://ghcr.io/helmforgedev/helm/superset --version <version> -f values.yaml

Upgrading from Superset 4

This chart crosses the Superset 5 and 6 major releases. Back up the metadata database before upgrading and plan for migration downtime. The chart's init Job runs superset db upgrade and superset init before the application workloads become ready. Superset 6 removes AUTH_OID; installations using it must move to OAuth, LDAP, or database authentication first. Custom frontend extensions may also need changes for the React upgrade introduced in Superset 5.

Review the upstream Superset 5 update notes and Superset 6 update notes before upgrading production installations.

Architecture

Client -> Service -> web Deployment -> PostgreSQL and Redis
Celery worker Deployment -> PostgreSQL and Redis
Celery Beat Deployment -> Redis
init Job -> PostgreSQL
web, worker, and beat init containers -> init Job status
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 | apache/superset | Container image | | image.tag | "6.1.0" | Immutable image tag | | superset.adminUsername | admin | Admin username | | superset.adminPassword | "" (auto) | Admin password | | superset.secretKey | "" (auto) | Flask SECRET_KEY | | superset.loadExamples | false | Load example dashboards | | superset.installPythonPackages | true | Install runtime Python dependencies at process startup | | superset.extraPythonPackages | [] | Additional Python package specifications installed in every Superset process | | web.replicaCount | 1 | Web server replicas | | web.containerPort | 8088 | Gunicorn listener port | | web.workers | 2 | Gunicorn workers | | web.timeout | 120 | Gunicorn timeout | | worker.enabled | true | Enable Celery workers | | worker.replicaCount | 1 | Worker replicas | | worker.concurrency | 2 | Celery concurrency | | beat.enabled | true | Enable Celery beat | | init.enabled | true | Enable init job | | database.mode | subchart | Database mode: subchart or external | | redisConfig.mode | subchart | Redis mode: subchart or external | | service.type | ClusterIP | Service type | | service.port | 80 | Service port | | ingress.enabled | false | Enable ingress | | ingress.ingressClassName | traefik | Ingress class | | networkPolicy.enabled | true | Restrict ingress to the web listener | | postgresql.enabled | true | Enable PostgreSQL subchart | | postgresql.standalone.persistence.enabled | true | Enable persistent storage for bundled PostgreSQL | | postgresql.standalone.persistence.storageClass | "" | Storage class for bundled PostgreSQL; empty uses the cluster default | | postgresql.standalone.persistence.accessModes | [ReadWriteOnce] | Access modes for the bundled PostgreSQL PVC | | postgresql.standalone.persistence.size | 8Gi | Bundled PostgreSQL PVC size | | redis.enabled | true | Enable Redis subchart | | redis.standalone.persistence.enabled | true | Enable persistent storage for bundled Redis | | redis.standalone.persistence.storageClass | "" | Storage class for bundled Redis; empty uses the cluster default | | redis.standalone.persistence.accessModes | [ReadWriteOnce] | Access modes for the bundled Redis PVC | | redis.standalone.persistence.size | 8Gi | Bundled Redis PVC size |

Bundled Storage

PostgreSQL and Redis are enabled in standalone mode by default. Configure their PVCs through each subchart's standalone.persistence values. Leave storageClass empty to use the cluster's default StorageClass.

postgresql:
  enabled: true
  standalone:
    persistence:
      enabled: true
      storageClass: fast-storage
      size: 20Gi

redis:
  enabled: true
  standalone:
    persistence:
      enabled: true
      storageClass: fast-storage
      size: 8Gi

External Database

postgresql:
  enabled: false

database:
  mode: external
  external:
    host: postgres.example.com
    port: 5432
    name: superset
    username: superset
    existingSecret: superset-database
    existingSecretPasswordKey: password
    sslMode: verify-full

External Redis

redis:
  enabled: false

redisConfig:
  mode: external
  external:
    host: redis.example.com
    port: 6379
    tls: true
    existingSecret: superset-redis
    existingSecretPasswordKey: password
    db: 0

Ingress

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

Custom Configuration

Extend superset_config.py via superset.extraConfig:

superset:
  extraConfig: |
    FEATURE_FLAGS = {
        "DASHBOARD_NATIVE_FILTERS": True,
        "DASHBOARD_CROSS_FILTERS": True,
    }
    ROW_LIMIT = 50000

Additional Python Packages

Use superset.extraPythonPackages for development and simpler deployments that need optional database drivers. Package entries support names with optional version constraints. Pin a tested version so every Superset process receives the same dependency:

superset:
  extraPythonPackages:
    - clickhouse-connect==0.13.0

Superset 6.1.0 recommends clickhouse-connect>=0.13.0 for ClickHouse and uses the clickhousedb://user:password@host:port/database SQLAlchemy URI.

These packages are downloaded when the init, web, worker, and beat containers start. Their startup therefore depends on package-index availability. For production, build an immutable image instead:

FROM apache/superset:6.1.0

USER root

RUN . /app/.venv/bin/activate && \
    uv pip install psycopg2-binary redis "clickhouse-connect==0.13.0"

USER superset

Push the image to your registry, then configure its immutable tag and disable runtime installation:

image:
  repository: registry.example.com/superset
  tag: 6.1.0-clickhouse-0.13.0

superset:
  installPythonPackages: false

When runtime installation is disabled, the image must contain psycopg2-binary, redis, and every entry from extraPythonPackages.

Security

The default containers run as UID/GID 1000, use RuntimeDefault seccomp, drop all Linux capabilities, block privilege escalation, and mount a read-only root filesystem. Ephemeral volumes provide only /tmp and /app/superset_home as writable paths. The initialization and backup Jobs do not receive Kubernetes API tokens. Application pods receive a namespaced token only while init.enabled=true, because their wait container must read the initialization Job status.

superset.secretKey signs sessions and encrypts sensitive metadata. The chart preserves an auto-generated key across Helm upgrades, but production operators should provide superset.existingSecret and include that Secret in the recovery plan. Treat superset.extraConfig as trusted Python code.

The default NetworkPolicy permits only the configured Superset listener for ingress and allows egress. Restrict networkPolicy.ingressFrom and networkPolicy.egress for the ingress controller, DNS, datastores, Python package index, external data sources used by the deployment, and the Kubernetes API server while init.enabled=true.

Troubleshooting

Inspect initialization before debugging the long-running workloads:

kubectl get job,pod -n <namespace> -l app.kubernetes.io/instance=<release>
kubectl logs -n <namespace> job/<release>-superset-init-<revision>
kubectl logs -n <namespace> deployment/<release>-superset-web --tail=200
kubectl get events -n <namespace> --sort-by=.lastTimestamp

If a pod waits for PostgreSQL or Redis, verify the selected datastore mode, Service name, Secret key, TLS setting, and NetworkPolicy egress. If the web pod is running but not Ready, test /health on web.containerPort from inside the pod. See the operations guide for upgrade and recovery checks.

More Information

🟢 Security Scan: superset

Framework Score
MITRE + NSA + SOC2 76.46465%

✅ Security posture acceptable.

System Architecture

DESIGN.md Synced

Verified architecture contract rendered dynamically from GitHub DESIGN.md

flowchart LR
  Client[Client or Ingress] --> Service[Superset Service]
  Service --> Web[Gunicorn web Deployment]
  Web --> PostgreSQL[(PostgreSQL metadata)]
  Web --> Redis[(Redis cache and broker)]
  Worker[Celery worker Deployment] --> PostgreSQL
  Worker --> Redis
  Beat[Celery Beat Deployment] --> Redis
  Init[Initialization Job] --> PostgreSQL
  Workloads[Web worker and beat init containers] --> Init
Official Contractvalues.schema.json

Superset Values Schema Reference

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

162 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.repositorystringdocker.io/apache/supersetChart configuration parameter
image.tagstring""Chart configuration parameter
image.pullPolicystringIfNotPresentChart configuration parameter
Allowed:AlwaysIfNotPresentNever

Image Pull Secrets(1)

ParameterTypeDefaultDescription
imagePullSecretsarray-Chart configuration parameter

Superset(14)

ParameterTypeDefaultDescription
superset.adminUsernamestringadminChart configuration parameter
superset.adminFirstNamestringAdminChart configuration parameter
superset.adminLastNamestringUserChart configuration parameter
superset.adminEmailstring[email protected]Chart configuration parameter
superset.adminPasswordstring""Chart configuration parameter
superset.existingSecretstring""Chart configuration parameter
superset.existingSecretPasswordKeystringadmin-passwordChart configuration parameter
superset.secretKeystring""Chart configuration parameter
superset.existingSecretSecretKeyKeystringsecret-keyChart configuration parameter
superset.loadExamplesbooleanfalseChart configuration parameter
superset.extraEnvarray-Chart configuration parameter
superset.installPythonPackagesbooleantrueInstall built-in and additional Python packages when each Superset process starts
superset.extraPythonPackagesarray[]Additional Python package names with optional version constraints, installed in every Superset process
superset.extraConfigstring""Chart configuration parameter

Web(8)

ParameterTypeDefaultDescription
web.replicaCountinteger1Chart configuration parameter
web.containerPortinteger8088Chart configuration parameter
web.workersinteger2Chart configuration parameter
web.timeoutinteger120Chart configuration parameter
web.extraEnvarray-Chart configuration parameter
web.resourcesobject-Chart configuration parameter
web.podLabelsobject-Chart configuration parameter
web.podAnnotationsobject-Chart configuration parameter

Worker(7)

ParameterTypeDefaultDescription
worker.enabledbooleantrueChart configuration parameter
worker.replicaCountinteger1Chart configuration parameter
worker.concurrencyinteger2Chart configuration parameter
worker.extraEnvarray-Chart configuration parameter
worker.resourcesobject-Chart configuration parameter
worker.podLabelsobject-Chart configuration parameter
worker.podAnnotationsobject-Chart configuration parameter

Beat(5)

ParameterTypeDefaultDescription
beat.enabledbooleantrueChart configuration parameter
beat.extraEnvarray-Chart configuration parameter
beat.resourcesobject-Chart configuration parameter
beat.podLabelsobject-Chart configuration parameter
beat.podAnnotationsobject-Chart configuration parameter

Init(4)

ParameterTypeDefaultDescription
init.enabledbooleantrueChart configuration parameter
init.waitImagestring-Chart configuration parameter
init.extraEnvarray-Chart configuration parameter
init.resourcesobject-Chart configuration parameter

Database(9)

ParameterTypeDefaultDescription
database.modestringsubchartChart configuration parameter
Allowed:subchartexternal
database.external.hoststring""Chart configuration parameter
database.external.portinteger5432Chart configuration parameter
database.external.namestringsupersetChart configuration parameter
database.external.usernamestringsupersetChart configuration parameter
database.external.passwordstring""Chart configuration parameter
database.external.existingSecretstring""Chart configuration parameter
database.external.existingSecretPasswordKeystringpasswordChart configuration parameter
database.external.sslModestringrequireChart configuration parameter
Allowed:disableallowpreferrequireverify-caverify-full

Redis Config(8)

ParameterTypeDefaultDescription
redisConfig.modestringsubchartChart configuration parameter
Allowed:subchartexternal
redisConfig.external.hoststring""Chart configuration parameter
redisConfig.external.portinteger6379Chart configuration parameter
redisConfig.external.passwordstring""Chart configuration parameter
redisConfig.external.dbinteger0Chart configuration parameter
redisConfig.external.tlsbooleanfalseChart configuration parameter
redisConfig.external.existingSecretstring""Chart configuration parameter
redisConfig.external.existingSecretPasswordKeystringpasswordChart configuration parameter

Service & Networking(3)

ParameterTypeDefaultDescription
service.typestringClusterIPChart configuration parameter
Allowed:ClusterIPNodePortLoadBalancer
service.portinteger80Chart configuration parameter
service.annotationsobject-Chart configuration parameter

Ingress(5)

ParameterTypeDefaultDescription
ingress.enabledbooleanfalseChart configuration parameter
ingress.ingressClassNamestringtraefikChart configuration parameter
ingress.annotationsobject-Chart configuration parameter
ingress.hostsarray-Chart configuration parameter
ingress.tlsarray-Chart configuration parameter

Health Probes(18)

ParameterTypeDefaultDescription
probes.liveness.httpGet.pathstring-Chart configuration parameter
probes.liveness.httpGet.portstringinteger-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.httpGet.pathstring-Chart configuration parameter
probes.readiness.httpGet.portstringinteger-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
probes.startup.httpGet.pathstring-Chart configuration parameter
probes.startup.httpGet.portstringinteger-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

Service Account(4)

ParameterTypeDefaultDescription
serviceAccount.createbooleantrueChart configuration parameter
serviceAccount.namestring""Chart configuration parameter
serviceAccount.annotationsobject-Chart configuration parameter
serviceAccount.automountServiceAccountTokenbooleantrueChart configuration parameter

Network Policy(3)

ParameterTypeDefaultDescription
networkPolicy.enabledbooleantrueChart configuration parameter
networkPolicy.ingressFromarray-Chart configuration parameter
networkPolicy.egressarray-Chart configuration parameter

Pod Security(3)

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

Container Security(6)

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

Resources(1)

ParameterTypeDefaultDescription
resourcesobject-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
terminationGracePeriodSecondsinteger30Chart configuration parameter

Pod Labels(1)

ParameterTypeDefaultDescription
podLabelsobject-Chart configuration parameter

Pod Annotations(1)

ParameterTypeDefaultDescription
podAnnotationsobject-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

Backup(28)

ParameterTypeDefaultDescription
backup.enabledbooleanfalseEnable scheduled backups
backup.schedulestring0 3 * * *Cron schedule for backups
backup.suspendbooleanfalseSuspend the CronJob
backup.concurrencyPolicystringForbidChart configuration parameter
Allowed:AllowForbidReplace
backup.successfulJobsHistoryLimitinteger3Chart configuration parameter
backup.failedJobsHistoryLimitinteger3Chart configuration parameter
backup.backoffLimitinteger1Chart configuration parameter
backup.archivePrefixstringsupersetPrefix for backup archive filenames
backup.images.postgresqlstring-Chart configuration parameter
backup.images.uploaderstring-Chart configuration parameter
backup.resourcesobject-CPU and memory for backup containers
backup.s3.endpointstring-Chart configuration parameter
backup.s3.bucketstring-Chart configuration parameter
backup.s3.prefixstring-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
backup.database.hoststring-Chart configuration parameter
backup.database.portstringinteger-Chart configuration parameter
backup.database.namestring-Chart configuration parameter
backup.database.usernamestring-Chart configuration parameter
backup.database.passwordstring-Chart configuration parameter
backup.database.existingSecretstring-Chart configuration parameter
backup.database.existingSecretPasswordKeystring-Chart configuration parameter
backup.database.postgresDumpArgsstring-Chart configuration parameter

Postgresql(9)

ParameterTypeDefaultDescription
postgresql.enabledbooleantrueChart configuration parameter
postgresql.architecturestringstandaloneChart configuration parameter
Allowed:standalonereplication
postgresql.auth.databasestring-Chart configuration parameter
postgresql.auth.usernamestring-Chart configuration parameter
postgresql.auth.passwordstring-Chart configuration parameter
postgresql.standalone.persistence.enabledbooleantrueEnable persistent storage for bundled PostgreSQL
postgresql.standalone.persistence.storageClassstring""Storage class for bundled PostgreSQL. Empty uses the cluster default.
postgresql.standalone.persistence.accessModesarray["ReadWriteOnce"]Access modes for the bundled PostgreSQL PVC
postgresql.standalone.persistence.sizestring8GiSize of the bundled PostgreSQL PVC

Redis(8)

ParameterTypeDefaultDescription
redis.enabledbooleantrueChart configuration parameter
redis.architecturestringstandaloneChart configuration parameter
Allowed:standalonereplication
redis.auth.enabledbooleantrueChart configuration parameter
redis.auth.passwordstring-Chart configuration parameter
redis.standalone.persistence.enabledbooleantrueEnable persistent storage for bundled Redis
redis.standalone.persistence.storageClassstring""Storage class for bundled Redis. Empty uses the cluster default.
redis.standalone.persistence.accessModesarray["ReadWriteOnce"]Access modes for the bundled Redis PVC
redis.standalone.persistence.sizestring8GiSize of the bundled Redis PVC