Skip to content
Flowise icon
v1.4.3App: v3.1.3Pinned DigestS3 Backup Ready

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

Flowise

A production-oriented Helm chart for deploying Flowise with a simple standalone topology or scalable queue workers backed by PostgreSQL, Redis, and S3-compatible storage.

Features

  • Official docker.io/flowiseai/flowise image pinned to version 3.1.3.
  • Standalone SQLite mode with persistent local data for small installations.
  • Queue mode with independently scalable main and worker Deployments.
  • Optional HelmForge PostgreSQL and Redis subcharts or external services.
  • Local and S3-compatible blob storage.
  • Ingress and Gateway API exposure with a named Service targetPort.
  • Configurable Flowise process port, verified in a behavioral k3d scenario.
  • Default non-root execution, read-only root filesystem, RuntimeDefault seccomp, dropped capabilities, disabled API token mounting, and NetworkPolicy.
  • Existing Secret support for application, database, Redis, storage, and backup credentials, plus External Secrets Operator integration.
  • Scheduled PostgreSQL backups to S3-compatible object storage.
  • JSON Schema validation, Helm unit tests, examples, and runtime smoke tests.

Installation

From the HTTPS repository:

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

From the OCI registry:

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

Wait for the server and test the upstream health endpoint:

kubectl wait --for=condition=available deployment/flowise --timeout=300s
kubectl port-forward service/flowise 3000:3000
curl -fsS http://127.0.0.1:3000/api/v1/ping

Resource names include the Helm release name when it differs from the chart name. Use kubectl get deploy,service -l app.kubernetes.io/instance=flowise to discover the exact names.

Architecture

Standalone mode

Standalone is the default. One Flowise server uses SQLite and local blob storage on a PVC mounted at /home/node/.flowise. SQLite or local storage restricts the main Deployment to one replica. This topology is suitable for evaluation, personal use, and smaller installations where a single availability zone is acceptable.

Queue mode

Queue mode separates HTTP handling from asynchronous prediction work. Main pods enqueue work in Redis and worker pods process it. Main and worker pods share PostgreSQL state and S3-compatible blob storage. The chart rejects queue mode unless all required services are configured and local persistence is disabled.

Upstream recommends queue mode for production. See examples/queue-s3.yaml and the architecture guide.

Configuration

The following values describe the primary decisions. The complete contract, including types and constraints, is in values.yaml and values.schema.json.

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

Do not set service.port when the intent is to change the Flowise listener. Set flowise.containerPort; the Service continues to target the named http port. See the configuration guide for external database, Secret, networking, and port examples.

Examples

Standalone with an Ingress:

ingress:
  enabled: true
  ingressClassName: traefik
  hosts:
    - host: flowise.example.com
      paths:
        - path: /
          pathType: Prefix
auth:
  existingSecret: flowise-auth

Queue mode with bundled datastores and an existing S3 Secret:

architecture:
  mode: queue
flowise:
  replicaCount: 2
queue:
  worker:
    replicaCount: 4
postgresql:
  enabled: true
redis:
  enabled: true
persistence:
  enabled: false
storage:
  type: s3
  s3:
    bucketName: flowise
    endpointUrl: https://s3.example.com
    existingSecret: flowise-s3

Reusable files are available in examples/:

Security

The official 3.1.3 image defaults to root, but contains the node user as UID and GID 1000. The chart deliberately runs it as that non-root identity. The root filesystem is read-only; writable application data and /tmp are explicit volumes. A dedicated ServiceAccount is created without an automatically mounted API token.

The main NetworkPolicy admits the configured Flowise listener and the worker policy denies all inbound traffic. Egress is open by default because Flowise connects to operator-selected model providers, databases, Redis, and object storage. Restrict networkPolicy.egress only after enumerating those endpoints.

Flowise includes nodes that can execute code or invoke external tools. Treat administrative access as privileged, keep upstream HTTP and custom MCP security checks enabled, and do not inject cluster-wide or cloud-admin credentials into the pod. Read the security guide before public exposure.

Security Scan: flowise

Framework Score
MITRE + NSA + SOC2 90.91%

Security posture acceptable.

Operations

Use /api/v1/ping for external monitoring. Probe timings are independently configurable. Logs are available through kubectl logs and are also written to the persistent data path. Queue mode requires monitoring both the main and worker Deployments as well as PostgreSQL, Redis, and object storage.

PostgreSQL backups use a CronJob and S3-compatible target. Extra pg_dump arguments are an array so the shell never evaluates operator input. Restoration is intentionally manual. See backup and restore and operations.

Troubleshooting

Inspect all Flowise resources and recent logs:

kubectl get all,pvc,networkpolicy -l app.kubernetes.io/instance=flowise
kubectl describe deployment -l app.kubernetes.io/instance=flowise
kubectl logs deployment/flowise --all-containers --tail=200

If the default pod is not writable, confirm the storage class honors fsGroup and that any existing volume content is accessible to UID/GID 1000. Queue mode validation failures normally identify the missing database, Redis, S3, or persistence setting directly. For application-level startup failures, verify that external service hostnames are resolvable from the namespace.

Documentation

System Architecture

DESIGN.md Synced

Verified architecture contract rendered dynamically from GitHub DESIGN.md

flowchart LR
  Client[Client] --> Exposure[Ingress or Gateway]
  Exposure --> Service[Flowise Service]
  Service --> Main[Main Deployment]
  Main --> Database[(PostgreSQL or SQLite)]
  Main --> Redis[(Redis)]
  Main --> Storage[(Local PVC or S3)]
  Worker[Worker Deployment] --> Database
  Worker --> Redis
  Worker --> Storage
  Backup[Backup CronJob] --> Database
  Backup --> BackupStore[(S3 backup bucket)]
Official Contractvalues.schema.json

Flowise Values Schema Reference

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

191 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

Image(3)

ParameterTypeDefaultDescription
image.repositorystring-Flowise container image repository
image.tagstring-Flowise image tag. Defaults to appVersion validated on GitHub Releases and Docker Hub.
image.pullPolicystring-Image pull policy
Allowed:AlwaysIfNotPresentNever

Image Pull Secrets(1)

ParameterTypeDefaultDescription
imagePullSecretsarray-Image pull secrets for private registries

Architecture(1)

ParameterTypeDefaultDescription
architecture.modestring-Flowise architecture mode: standalone | queue
Allowed:standalonequeue

Flowise(15)

ParameterTypeDefaultDescription
flowise.replicaCountinteger-Number of main Flowise server replicas
flowise.containerPortinteger-HTTP port listened on by the Flowise process
flowise.startupDelaySecondsinteger-Delay before starting the main Flowise server, in seconds
flowise.appUrlstring-Public application URL. Auto-detected from the first ingress host when empty.
flowise.logLevelstring-Log level: error | warn | info | verbose | debug
flowise.logPathstring-Writable directory for Flowise application logs
flowise.secretKeyPathstring-Writable directory used by Flowise for local secret-key state
flowise.numberOfProxiesinteger-Rate-limit proxy count when running behind ingress or load balancers
flowise.corsOriginsstring-Allowed CORS origins
flowise.iframeOriginsstring-Allowed iframe origins
flowise.fileSizeLimitstring-Maximum upload size accepted by Flowise
flowise.showCommunityNodesboolean-Show community nodes in the UI
flowise.disableTelemetryboolean-Disable telemetry reporting
flowise.disabledNodesstring-Disable selected node names, comma-separated
flowise.extraEnvarray-Extra environment variables for the main Flowise container

Authentication(12)

ParameterTypeDefaultDescription
auth.existingSecretstring-Chart configuration parameter
auth.existingSecretEncryptionKeyKeystring-Chart configuration parameter
auth.existingSecretJwtAuthTokenSecretKeystring-Chart configuration parameter
auth.existingSecretJwtRefreshTokenSecretKeystring-Chart configuration parameter
auth.existingSecretExpressSessionSecretKeystring-Chart configuration parameter
auth.existingSecretTokenHashSecretKeystring-Chart configuration parameter
auth.encryptionKeystring-Chart configuration parameter
auth.jwtAuthTokenSecretstring-Chart configuration parameter
auth.jwtRefreshTokenSecretstring-Chart configuration parameter
auth.expressSessionSecretstring-Chart configuration parameter
auth.tokenHashSecretstring-Chart configuration parameter
auth.secureCookiesboolean-Chart configuration parameter

Database(13)

ParameterTypeDefaultDescription
database.modestring-Database mode: auto | sqlite | external | postgresql
Allowed:autosqliteexternalpostgresql
database.sqlite.pathstring-Chart configuration parameter
database.external.vendorstring-Chart configuration parameter
Allowed:postgresmysql
database.external.hoststring-Chart configuration parameter
database.external.portintegerstring-Chart configuration parameter
database.external.namestring-Chart configuration parameter
database.external.usernamestring-Chart configuration parameter
database.external.passwordstring-Chart configuration parameter
database.external.existingSecretstring-Chart configuration parameter
database.external.existingSecretPasswordKeystring-Chart configuration parameter
database.external.sslboolean-Chart configuration parameter
database.external.rejectUnauthorizedboolean-Chart configuration parameter
database.external.sslKeyBase64string-Chart configuration parameter

Postgresql(8)

ParameterTypeDefaultDescription
postgresql.enabledboolean-Chart configuration parameter
postgresql.architecturestring-Chart configuration parameter
postgresql.auth.databasestring-Chart configuration parameter
postgresql.auth.usernamestring-Chart configuration parameter
postgresql.auth.passwordstring-Chart configuration parameter
postgresql.auth.postgresPasswordstring-Chart configuration parameter
postgresql.standaloneobject-Chart configuration parameter
postgresql.initdbobject-Chart configuration parameter

Queue(10)

ParameterTypeDefaultDescription
queue.namestring-Queue name used by Flowise main and workers
queue.worker.replicaCountinteger-Number of Flowise worker replicas in queue mode
queue.worker.startupDelaySecondsinteger-Delay before starting workers, in seconds
queue.worker.concurrencyinteger-Worker concurrency for BullMQ jobs
queue.worker.removeOnAgeinteger-Number of completed jobs kept by age
queue.worker.removeOnCountinteger-Number of completed jobs kept by count
queue.worker.podLabelsobject-Labels added to Flowise worker pods
queue.worker.podAnnotationsobject-Annotations added to Flowise worker pods
queue.worker.extraEnvarray-Additional environment variables for Flowise workers
queue.worker.resourcesobject-CPU and memory requests/limits for Flowise workers

Redis(11)

ParameterTypeDefaultDescription
redis.enabledboolean-Chart configuration parameter
redis.architecturestring-Chart configuration parameter
redis.auth.enabledboolean-Chart configuration parameter
redis.auth.passwordstring-Chart configuration parameter
redis.standaloneobject-Chart configuration parameter
redis.external.hoststring-Chart configuration parameter
redis.external.portinteger-Chart configuration parameter
redis.external.usernamestring-Chart configuration parameter
redis.external.passwordstring-Chart configuration parameter
redis.external.existingSecretstring-Chart configuration parameter
redis.external.existingSecretPasswordKeystring-Chart configuration parameter

Storage(11)

ParameterTypeDefaultDescription
storage.typestring-Storage type: local | s3
Allowed:locals3
storage.local.pathstring-Chart configuration parameter
storage.s3.bucketNamestring-Chart configuration parameter
storage.s3.accessKeyIdstring-Chart configuration parameter
storage.s3.secretAccessKeystring-Chart configuration parameter
storage.s3.regionstring-Chart configuration parameter
storage.s3.endpointUrlstring-Chart configuration parameter
storage.s3.forcePathStyleboolean-Chart configuration parameter
storage.s3.existingSecretstring-Chart configuration parameter
storage.s3.existingSecretAccessKeyKeystring-Chart configuration parameter
storage.s3.existingSecretSecretKeyKeystring-Chart configuration parameter

Persistence(7)

ParameterTypeDefaultDescription
persistence.enabledboolean-Chart configuration parameter
persistence.storageClassstring-Chart configuration parameter
persistence.accessModestring-Chart configuration parameter
persistence.sizestring-Chart configuration parameter
persistence.existingClaimstring-Chart configuration parameter
persistence.mountPathstring-Chart configuration parameter
persistence.annotationsobject-Chart configuration parameter

Service & Networking(5)

ParameterTypeDefaultDescription
service.typestring-Service type
Allowed:ClusterIPNodePortLoadBalancer
service.portinteger-Service port
service.ipFamilyPolicystringnull-Dual-stack ipFamilyPolicy (GR-058)
Allowed:nullSingleStackPreferDualStackRequireDualStack
service.ipFamiliesarray-Dual-stack ipFamilies (GR-058)
service.annotationsobject-Annotations for the service

Ingress(5)

ParameterTypeDefaultDescription
ingress.enabledboolean-Chart configuration parameter
ingress.ingressClassNamestring-Chart configuration parameter
ingress.annotationsobject-Chart configuration parameter
ingress.hostsarray-Chart configuration parameter
ingress.tlsarray-Chart configuration parameter

Startup Probe(6)

ParameterTypeDefaultDescription
startupProbe.enabledboolean-Chart configuration parameter
startupProbe.pathstring-Chart configuration parameter
startupProbe.initialDelaySecondsinteger-Chart configuration parameter
startupProbe.periodSecondsinteger-Chart configuration parameter
startupProbe.timeoutSecondsinteger-Chart configuration parameter
startupProbe.failureThresholdinteger-Chart configuration parameter

Liveness Probe(6)

ParameterTypeDefaultDescription
livenessProbe.enabledboolean-Chart configuration parameter
livenessProbe.pathstring-Chart configuration parameter
livenessProbe.initialDelaySecondsinteger-Chart configuration parameter
livenessProbe.periodSecondsinteger-Chart configuration parameter
livenessProbe.timeoutSecondsinteger-Chart configuration parameter
livenessProbe.failureThresholdinteger-Chart configuration parameter

Readiness Probe(6)

ParameterTypeDefaultDescription
readinessProbe.enabledboolean-Chart configuration parameter
readinessProbe.pathstring-Chart configuration parameter
readinessProbe.initialDelaySecondsinteger-Chart configuration parameter
readinessProbe.periodSecondsinteger-Chart configuration parameter
readinessProbe.timeoutSecondsinteger-Chart configuration parameter
readinessProbe.failureThresholdinteger-Chart configuration parameter

Resources(1)

ParameterTypeDefaultDescription
resourcesobject-CPU and memory requests/limits for the main Flowise container

Pod Security(5)

ParameterTypeDefaultDescription
podSecurityContext.runAsNonRootboolean-Chart configuration parameter
podSecurityContext.runAsUserinteger-Chart configuration parameter
podSecurityContext.runAsGroupinteger-Chart configuration parameter
podSecurityContext.fsGroupinteger-Chart configuration parameter
podSecurityContext.seccompProfile.typestring-Chart configuration parameter
Allowed:RuntimeDefaultLocalhostUnconfined

Container Security(3)

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

Service Account(4)

ParameterTypeDefaultDescription
serviceAccount.createboolean-Chart configuration parameter
serviceAccount.namestring-Chart configuration parameter
serviceAccount.annotationsobject-Chart configuration parameter
serviceAccount.automountServiceAccountTokenboolean-Chart configuration parameter

Network Policy(3)

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

Priority Class Name(1)

ParameterTypeDefaultDescription
priorityClassNamestring-Priority class name

Pod Labels(1)

ParameterTypeDefaultDescription
podLabelsobject-Labels added to the main Flowise pod

Pod Annotations(1)

ParameterTypeDefaultDescription
podAnnotationsobject-Annotations added to the main Flowise pod

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

Extra Volume Mounts(1)

ParameterTypeDefaultDescription
extraVolumeMountsarray-Additional volume mounts for the main Flowise container

Extra Volumes(1)

ParameterTypeDefaultDescription
extraVolumesarray-Additional volumes for the Flowise pods

Extra Manifests(1)

ParameterTypeDefaultDescription
extraManifestsarray-Extra Kubernetes manifests to deploy alongside the chart

Backup(29)

ParameterTypeDefaultDescription
backup.enabledboolean-Enable scheduled PostgreSQL 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.postgresqlstring-Image used for PostgreSQL backup (must have pg_dump)
backup.images.uploaderstring-Image used for S3 upload (MinIO client)
backup.resourcesobject-Resources for backup containers
backup.podSecurityContext.runAsNonRootboolean-Chart configuration parameter
backup.podSecurityContext.runAsUserinteger-Chart configuration parameter
backup.podSecurityContext.runAsGroupinteger-Chart configuration parameter
backup.podSecurityContext.fsGroupinteger-Chart configuration parameter
backup.podSecurityContext.seccompProfile.typestring-Chart configuration parameter
Allowed:RuntimeDefaultLocalhostUnconfined
backup.securityContext.allowPrivilegeEscalationboolean-Chart configuration parameter
backup.securityContext.readOnlyRootFilesystemboolean-Chart configuration parameter
backup.securityContext.capabilities.droparray-Chart configuration parameter
backup.database.pgDumpArgsany-Extra pg_dump arguments. Arrays are preferred; legacy space-delimited strings remain accepted for upgrade compatibility.
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)

Gateway(6)

ParameterTypeDefaultDescription
gateway.enabledbooleanfalseChart configuration parameter
gateway.annotationsobject-Chart configuration parameter
gateway.parentRefsarray-Chart configuration parameter
gateway.hostnamesarray-Chart configuration parameter
gateway.pathstring/Chart configuration parameter
gateway.pathTypestringPathPrefixChart configuration parameter
Allowed:PathPrefixExactRegularExpression

External Secrets(7)

ParameterTypeDefaultDescription
externalSecrets.enabledbooleanfalseChart configuration parameter
externalSecrets.apiVersionstringexternal-secrets.io/v1Chart configuration parameter
externalSecrets.refreshIntervalstring1hChart configuration parameter
externalSecrets.secretStoreRef.namestring-Chart configuration parameter
externalSecrets.secretStoreRef.kindstring-Chart configuration parameter
externalSecrets.target.creationPolicystring-Chart configuration parameter
externalSecrets.dataarray-Chart configuration parameter