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
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.
|-----|---------|-------------|
| 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 SyncedVerified 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
Superset Values Schema Reference
Official schema parameters, default values, and types extracted directly from the chart repository.
Global(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| global | object | - | Global settings shared by the chart. |
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 |
Image(3)
| Parameter | Type | Default | Description |
|---|---|---|---|
| image.repository | string | docker.io/apache/superset | Chart configuration parameter |
| image.tag | string | "" | Chart configuration parameter |
| image.pullPolicy | string | IfNotPresent | Chart configuration parameter Allowed: AlwaysIfNotPresentNever |
Image Pull Secrets(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| imagePullSecrets | array | - | Chart configuration parameter |
Superset(14)
| Parameter | Type | Default | Description |
|---|---|---|---|
| superset.adminUsername | string | admin | Chart configuration parameter |
| superset.adminFirstName | string | Admin | Chart configuration parameter |
| superset.adminLastName | string | User | Chart configuration parameter |
| superset.adminEmail | string | [email protected] | Chart configuration parameter |
| superset.adminPassword | string | "" | Chart configuration parameter |
| superset.existingSecret | string | "" | Chart configuration parameter |
| superset.existingSecretPasswordKey | string | admin-password | Chart configuration parameter |
| superset.secretKey | string | "" | Chart configuration parameter |
| superset.existingSecretSecretKeyKey | string | secret-key | Chart configuration parameter |
| superset.loadExamples | boolean | false | Chart configuration parameter |
| superset.extraEnv | array | - | Chart configuration parameter |
| superset.installPythonPackages | boolean | true | Install built-in and additional Python packages when each Superset process starts |
| superset.extraPythonPackages | array | [] | Additional Python package names with optional version constraints, installed in every Superset process |
| superset.extraConfig | string | "" | Chart configuration parameter |
Web(8)
| Parameter | Type | Default | Description |
|---|---|---|---|
| web.replicaCount | integer | 1 | Chart configuration parameter |
| web.containerPort | integer | 8088 | Chart configuration parameter |
| web.workers | integer | 2 | Chart configuration parameter |
| web.timeout | integer | 120 | Chart configuration parameter |
| web.extraEnv | array | - | Chart configuration parameter |
| web.resources | object | - | Chart configuration parameter |
| web.podLabels | object | - | Chart configuration parameter |
| web.podAnnotations | object | - | Chart configuration parameter |
Worker(7)
| Parameter | Type | Default | Description |
|---|---|---|---|
| worker.enabled | boolean | true | Chart configuration parameter |
| worker.replicaCount | integer | 1 | Chart configuration parameter |
| worker.concurrency | integer | 2 | Chart configuration parameter |
| worker.extraEnv | array | - | Chart configuration parameter |
| worker.resources | object | - | Chart configuration parameter |
| worker.podLabels | object | - | Chart configuration parameter |
| worker.podAnnotations | object | - | Chart configuration parameter |
Beat(5)
| Parameter | Type | Default | Description |
|---|---|---|---|
| beat.enabled | boolean | true | Chart configuration parameter |
| beat.extraEnv | array | - | Chart configuration parameter |
| beat.resources | object | - | Chart configuration parameter |
| beat.podLabels | object | - | Chart configuration parameter |
| beat.podAnnotations | object | - | Chart configuration parameter |
Init(4)
| Parameter | Type | Default | Description |
|---|---|---|---|
| init.enabled | boolean | true | Chart configuration parameter |
| init.waitImage | string | - | Chart configuration parameter |
| init.extraEnv | array | - | Chart configuration parameter |
| init.resources | object | - | Chart configuration parameter |
Database(9)
| Parameter | Type | Default | Description |
|---|---|---|---|
| database.mode | string | subchart | Chart configuration parameter Allowed: subchartexternal |
| database.external.host | string | "" | Chart configuration parameter |
| database.external.port | integer | 5432 | Chart configuration parameter |
| database.external.name | string | superset | Chart configuration parameter |
| database.external.username | string | superset | Chart configuration parameter |
| database.external.password | string | "" | Chart configuration parameter |
| database.external.existingSecret | string | "" | Chart configuration parameter |
| database.external.existingSecretPasswordKey | string | password | Chart configuration parameter |
| database.external.sslMode | string | require | Chart configuration parameter Allowed: disableallowpreferrequireverify-caverify-full |
Redis Config(8)
| Parameter | Type | Default | Description |
|---|---|---|---|
| redisConfig.mode | string | subchart | Chart configuration parameter Allowed: subchartexternal |
| redisConfig.external.host | string | "" | Chart configuration parameter |
| redisConfig.external.port | integer | 6379 | Chart configuration parameter |
| redisConfig.external.password | string | "" | Chart configuration parameter |
| redisConfig.external.db | integer | 0 | Chart configuration parameter |
| redisConfig.external.tls | boolean | false | Chart configuration parameter |
| redisConfig.external.existingSecret | string | "" | Chart configuration parameter |
| redisConfig.external.existingSecretPasswordKey | string | password | Chart configuration parameter |
Service & Networking(3)
| Parameter | Type | Default | Description |
|---|---|---|---|
| service.type | string | ClusterIP | Chart configuration parameter Allowed: ClusterIPNodePortLoadBalancer |
| service.port | integer | 80 | Chart configuration parameter |
| service.annotations | object | - | Chart configuration parameter |
Ingress(5)
| Parameter | Type | Default | Description |
|---|---|---|---|
| ingress.enabled | boolean | false | Chart configuration parameter |
| ingress.ingressClassName | string | traefik | 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.liveness.httpGet.path | string | - | Chart configuration parameter |
| probes.liveness.httpGet.port | stringinteger | - | 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.httpGet.path | string | - | Chart configuration parameter |
| probes.readiness.httpGet.port | stringinteger | - | 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 |
| probes.startup.httpGet.path | string | - | Chart configuration parameter |
| probes.startup.httpGet.port | stringinteger | - | 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 |
Service Account(4)
| Parameter | Type | Default | Description |
|---|---|---|---|
| serviceAccount.create | boolean | true | Chart configuration parameter |
| serviceAccount.name | string | "" | Chart configuration parameter |
| serviceAccount.annotations | object | - | Chart configuration parameter |
| serviceAccount.automountServiceAccountToken | boolean | true | Chart configuration parameter |
Network Policy(3)
| Parameter | Type | Default | Description |
|---|---|---|---|
| networkPolicy.enabled | boolean | true | Chart configuration parameter |
| networkPolicy.ingressFrom | array | - | Chart configuration parameter |
| networkPolicy.egress | array | - | Chart configuration parameter |
Pod Security(3)
| Parameter | Type | Default | Description |
|---|---|---|---|
| podSecurityContext.fsGroup | integer | - | Chart configuration parameter |
| podSecurityContext.fsGroupChangePolicy | string | - | Chart configuration parameter Allowed: AlwaysOnRootMismatch |
| podSecurityContext.seccompProfile.type | string | - | Chart configuration parameter Allowed: RuntimeDefaultLocalhostUnconfined |
Container Security(6)
| Parameter | Type | Default | Description |
|---|---|---|---|
| securityContext.allowPrivilegeEscalation | boolean | - | Chart configuration parameter |
| securityContext.capabilities.drop | array | - | Chart configuration parameter |
| securityContext.readOnlyRootFilesystem | boolean | - | Chart configuration parameter |
| securityContext.runAsNonRoot | boolean | - | Chart configuration parameter |
| securityContext.runAsUser | integer | - | Chart configuration parameter |
| securityContext.runAsGroup | integer | - | Chart configuration parameter |
Resources(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| resources | object | - | 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 | 30 | 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 |
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 |
Backup(28)
| Parameter | Type | Default | Description |
|---|---|---|---|
| backup.enabled | boolean | false | Enable scheduled backups |
| backup.schedule | string | 0 3 * * * | Cron schedule for backups |
| backup.suspend | boolean | false | Suspend the CronJob |
| backup.concurrencyPolicy | string | Forbid | Chart configuration parameter Allowed: AllowForbidReplace |
| backup.successfulJobsHistoryLimit | integer | 3 | Chart configuration parameter |
| backup.failedJobsHistoryLimit | integer | 3 | Chart configuration parameter |
| backup.backoffLimit | integer | 1 | Chart configuration parameter |
| backup.archivePrefix | string | superset | Prefix for backup archive filenames |
| backup.images.postgresql | string | - | Chart configuration parameter |
| backup.images.uploader | string | - | Chart configuration parameter |
| backup.resources | object | - | CPU and memory for backup containers |
| backup.s3.endpoint | string | - | Chart configuration parameter |
| backup.s3.bucket | string | - | Chart configuration parameter |
| backup.s3.prefix | string | - | 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 |
| backup.database.host | string | - | Chart configuration parameter |
| backup.database.port | stringinteger | - | Chart configuration parameter |
| backup.database.name | string | - | Chart configuration parameter |
| backup.database.username | string | - | Chart configuration parameter |
| backup.database.password | string | - | Chart configuration parameter |
| backup.database.existingSecret | string | - | Chart configuration parameter |
| backup.database.existingSecretPasswordKey | string | - | Chart configuration parameter |
| backup.database.postgresDumpArgs | string | - | Chart configuration parameter |
Postgresql(9)
| Parameter | Type | Default | Description |
|---|---|---|---|
| postgresql.enabled | boolean | true | Chart configuration parameter |
| postgresql.architecture | string | standalone | Chart configuration parameter Allowed: standalonereplication |
| postgresql.auth.database | string | - | Chart configuration parameter |
| postgresql.auth.username | string | - | Chart configuration parameter |
| postgresql.auth.password | string | - | Chart configuration parameter |
| postgresql.standalone.persistence.enabled | boolean | true | Enable persistent storage for bundled PostgreSQL |
| postgresql.standalone.persistence.storageClass | string | "" | Storage class for bundled PostgreSQL. Empty uses the cluster default. |
| postgresql.standalone.persistence.accessModes | array | ["ReadWriteOnce"] | Access modes for the bundled PostgreSQL PVC |
| postgresql.standalone.persistence.size | string | 8Gi | Size of the bundled PostgreSQL PVC |
Redis(8)
| Parameter | Type | Default | Description |
|---|---|---|---|
| redis.enabled | boolean | true | Chart configuration parameter |
| redis.architecture | string | standalone | Chart configuration parameter Allowed: standalonereplication |
| redis.auth.enabled | boolean | true | Chart configuration parameter |
| redis.auth.password | string | - | Chart configuration parameter |
| redis.standalone.persistence.enabled | boolean | true | Enable persistent storage for bundled Redis |
| redis.standalone.persistence.storageClass | string | "" | Storage class for bundled Redis. Empty uses the cluster default. |
| redis.standalone.persistence.accessModes | array | ["ReadWriteOnce"] | Access modes for the bundled Redis PVC |
| redis.standalone.persistence.size | string | 8Gi | Size of the bundled Redis PVC |
No schema parameters match your search
Try searching for a different keyword or reset the filter.