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/flowiseimage 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.
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.
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 SyncedVerified 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)]
Flowise 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 | - | Override the chart name used in resource names |
Fullname Override(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| fullnameOverride | string | - | Override the full release name used in resource names |
Common Labels(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| commonLabels | object | - | Labels added to every resource created by this chart |
Image(3)
| Parameter | Type | Default | Description |
|---|---|---|---|
| image.repository | string | - | Flowise container image repository |
| image.tag | string | - | Flowise image tag. Defaults to appVersion validated on GitHub Releases and Docker Hub. |
| image.pullPolicy | string | - | Image pull policy Allowed: AlwaysIfNotPresentNever |
Image Pull Secrets(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| imagePullSecrets | array | - | Image pull secrets for private registries |
Architecture(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| architecture.mode | string | - | Flowise architecture mode: standalone | queue Allowed: standalonequeue |
Flowise(15)
| Parameter | Type | Default | Description |
|---|---|---|---|
| flowise.replicaCount | integer | - | Number of main Flowise server replicas |
| flowise.containerPort | integer | - | HTTP port listened on by the Flowise process |
| flowise.startupDelaySeconds | integer | - | Delay before starting the main Flowise server, in seconds |
| flowise.appUrl | string | - | Public application URL. Auto-detected from the first ingress host when empty. |
| flowise.logLevel | string | - | Log level: error | warn | info | verbose | debug |
| flowise.logPath | string | - | Writable directory for Flowise application logs |
| flowise.secretKeyPath | string | - | Writable directory used by Flowise for local secret-key state |
| flowise.numberOfProxies | integer | - | Rate-limit proxy count when running behind ingress or load balancers |
| flowise.corsOrigins | string | - | Allowed CORS origins |
| flowise.iframeOrigins | string | - | Allowed iframe origins |
| flowise.fileSizeLimit | string | - | Maximum upload size accepted by Flowise |
| flowise.showCommunityNodes | boolean | - | Show community nodes in the UI |
| flowise.disableTelemetry | boolean | - | Disable telemetry reporting |
| flowise.disabledNodes | string | - | Disable selected node names, comma-separated |
| flowise.extraEnv | array | - | Extra environment variables for the main Flowise container |
Authentication(12)
| Parameter | Type | Default | Description |
|---|---|---|---|
| auth.existingSecret | string | - | Chart configuration parameter |
| auth.existingSecretEncryptionKeyKey | string | - | Chart configuration parameter |
| auth.existingSecretJwtAuthTokenSecretKey | string | - | Chart configuration parameter |
| auth.existingSecretJwtRefreshTokenSecretKey | string | - | Chart configuration parameter |
| auth.existingSecretExpressSessionSecretKey | string | - | Chart configuration parameter |
| auth.existingSecretTokenHashSecretKey | string | - | Chart configuration parameter |
| auth.encryptionKey | string | - | Chart configuration parameter |
| auth.jwtAuthTokenSecret | string | - | Chart configuration parameter |
| auth.jwtRefreshTokenSecret | string | - | Chart configuration parameter |
| auth.expressSessionSecret | string | - | Chart configuration parameter |
| auth.tokenHashSecret | string | - | Chart configuration parameter |
| auth.secureCookies | boolean | - | Chart configuration parameter |
Database(13)
| Parameter | Type | Default | Description |
|---|---|---|---|
| database.mode | string | - | Database mode: auto | sqlite | external | postgresql Allowed: autosqliteexternalpostgresql |
| database.sqlite.path | string | - | Chart configuration parameter |
| database.external.vendor | string | - | Chart configuration parameter Allowed: postgresmysql |
| database.external.host | string | - | Chart configuration parameter |
| database.external.port | integerstring | - | Chart configuration parameter |
| database.external.name | string | - | Chart configuration parameter |
| database.external.username | string | - | Chart configuration parameter |
| database.external.password | string | - | Chart configuration parameter |
| database.external.existingSecret | string | - | Chart configuration parameter |
| database.external.existingSecretPasswordKey | string | - | Chart configuration parameter |
| database.external.ssl | boolean | - | Chart configuration parameter |
| database.external.rejectUnauthorized | boolean | - | Chart configuration parameter |
| database.external.sslKeyBase64 | string | - | Chart configuration parameter |
Postgresql(8)
| Parameter | Type | Default | Description |
|---|---|---|---|
| postgresql.enabled | boolean | - | Chart configuration parameter |
| postgresql.architecture | string | - | Chart configuration parameter |
| postgresql.auth.database | string | - | Chart configuration parameter |
| postgresql.auth.username | string | - | Chart configuration parameter |
| postgresql.auth.password | string | - | Chart configuration parameter |
| postgresql.auth.postgresPassword | string | - | Chart configuration parameter |
| postgresql.standalone | object | - | Chart configuration parameter |
| postgresql.initdb | object | - | Chart configuration parameter |
Queue(10)
| Parameter | Type | Default | Description |
|---|---|---|---|
| queue.name | string | - | Queue name used by Flowise main and workers |
| queue.worker.replicaCount | integer | - | Number of Flowise worker replicas in queue mode |
| queue.worker.startupDelaySeconds | integer | - | Delay before starting workers, in seconds |
| queue.worker.concurrency | integer | - | Worker concurrency for BullMQ jobs |
| queue.worker.removeOnAge | integer | - | Number of completed jobs kept by age |
| queue.worker.removeOnCount | integer | - | Number of completed jobs kept by count |
| queue.worker.podLabels | object | - | Labels added to Flowise worker pods |
| queue.worker.podAnnotations | object | - | Annotations added to Flowise worker pods |
| queue.worker.extraEnv | array | - | Additional environment variables for Flowise workers |
| queue.worker.resources | object | - | CPU and memory requests/limits for Flowise workers |
Redis(11)
| Parameter | Type | Default | Description |
|---|---|---|---|
| redis.enabled | boolean | - | Chart configuration parameter |
| redis.architecture | string | - | Chart configuration parameter |
| redis.auth.enabled | boolean | - | Chart configuration parameter |
| redis.auth.password | string | - | Chart configuration parameter |
| redis.standalone | object | - | Chart configuration parameter |
| redis.external.host | string | - | Chart configuration parameter |
| redis.external.port | integer | - | Chart configuration parameter |
| redis.external.username | string | - | Chart configuration parameter |
| redis.external.password | string | - | Chart configuration parameter |
| redis.external.existingSecret | string | - | Chart configuration parameter |
| redis.external.existingSecretPasswordKey | string | - | Chart configuration parameter |
Storage(11)
| Parameter | Type | Default | Description |
|---|---|---|---|
| storage.type | string | - | Storage type: local | s3 Allowed: locals3 |
| storage.local.path | string | - | Chart configuration parameter |
| storage.s3.bucketName | string | - | Chart configuration parameter |
| storage.s3.accessKeyId | string | - | Chart configuration parameter |
| storage.s3.secretAccessKey | string | - | Chart configuration parameter |
| storage.s3.region | string | - | Chart configuration parameter |
| storage.s3.endpointUrl | string | - | Chart configuration parameter |
| storage.s3.forcePathStyle | boolean | - | Chart configuration parameter |
| storage.s3.existingSecret | string | - | Chart configuration parameter |
| storage.s3.existingSecretAccessKeyKey | string | - | Chart configuration parameter |
| storage.s3.existingSecretSecretKeyKey | string | - | Chart configuration parameter |
Persistence(7)
| Parameter | Type | Default | Description |
|---|---|---|---|
| persistence.enabled | boolean | - | Chart configuration parameter |
| persistence.storageClass | string | - | Chart configuration parameter |
| persistence.accessMode | string | - | Chart configuration parameter |
| persistence.size | string | - | Chart configuration parameter |
| persistence.existingClaim | string | - | Chart configuration parameter |
| persistence.mountPath | string | - | Chart configuration parameter |
| persistence.annotations | object | - | Chart configuration parameter |
Service & Networking(5)
| Parameter | Type | Default | Description |
|---|---|---|---|
| service.type | string | - | Service type Allowed: ClusterIPNodePortLoadBalancer |
| service.port | integer | - | Service port |
| service.ipFamilyPolicy | stringnull | - | Dual-stack ipFamilyPolicy (GR-058) Allowed: nullSingleStackPreferDualStackRequireDualStack |
| service.ipFamilies | array | - | Dual-stack ipFamilies (GR-058) |
| service.annotations | object | - | Annotations for the service |
Ingress(5)
| Parameter | Type | Default | Description |
|---|---|---|---|
| ingress.enabled | boolean | - | Chart configuration parameter |
| ingress.ingressClassName | string | - | Chart configuration parameter |
| ingress.annotations | object | - | Chart configuration parameter |
| ingress.hosts | array | - | Chart configuration parameter |
| ingress.tls | array | - | Chart configuration parameter |
Startup Probe(6)
| Parameter | Type | Default | Description |
|---|---|---|---|
| startupProbe.enabled | boolean | - | Chart configuration parameter |
| startupProbe.path | string | - | Chart configuration parameter |
| startupProbe.initialDelaySeconds | integer | - | Chart configuration parameter |
| startupProbe.periodSeconds | integer | - | Chart configuration parameter |
| startupProbe.timeoutSeconds | integer | - | Chart configuration parameter |
| startupProbe.failureThreshold | integer | - | Chart configuration parameter |
Liveness Probe(6)
| Parameter | Type | Default | Description |
|---|---|---|---|
| livenessProbe.enabled | boolean | - | Chart configuration parameter |
| livenessProbe.path | string | - | Chart configuration parameter |
| livenessProbe.initialDelaySeconds | integer | - | Chart configuration parameter |
| livenessProbe.periodSeconds | integer | - | Chart configuration parameter |
| livenessProbe.timeoutSeconds | integer | - | Chart configuration parameter |
| livenessProbe.failureThreshold | integer | - | Chart configuration parameter |
Readiness Probe(6)
| Parameter | Type | Default | Description |
|---|---|---|---|
| readinessProbe.enabled | boolean | - | Chart configuration parameter |
| readinessProbe.path | string | - | Chart configuration parameter |
| readinessProbe.initialDelaySeconds | integer | - | Chart configuration parameter |
| readinessProbe.periodSeconds | integer | - | Chart configuration parameter |
| readinessProbe.timeoutSeconds | integer | - | Chart configuration parameter |
| readinessProbe.failureThreshold | integer | - | Chart configuration parameter |
Resources(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| resources | object | - | CPU and memory requests/limits for the main Flowise container |
Pod Security(5)
| Parameter | Type | Default | Description |
|---|---|---|---|
| podSecurityContext.runAsNonRoot | boolean | - | Chart configuration parameter |
| podSecurityContext.runAsUser | integer | - | Chart configuration parameter |
| podSecurityContext.runAsGroup | integer | - | Chart configuration parameter |
| podSecurityContext.fsGroup | integer | - | Chart configuration parameter |
| podSecurityContext.seccompProfile.type | string | - | Chart configuration parameter Allowed: RuntimeDefaultLocalhostUnconfined |
Container Security(3)
| Parameter | Type | Default | Description |
|---|---|---|---|
| securityContext.allowPrivilegeEscalation | boolean | - | Chart configuration parameter |
| securityContext.readOnlyRootFilesystem | boolean | - | Chart configuration parameter |
| securityContext.capabilities.drop | array | - | Chart configuration parameter |
Service Account(4)
| Parameter | Type | Default | Description |
|---|---|---|---|
| serviceAccount.create | boolean | - | Chart configuration parameter |
| serviceAccount.name | string | - | Chart configuration parameter |
| serviceAccount.annotations | object | - | Chart configuration parameter |
| serviceAccount.automountServiceAccountToken | boolean | - | Chart configuration parameter |
Network Policy(3)
| Parameter | Type | Default | Description |
|---|---|---|---|
| networkPolicy.enabled | boolean | - | Chart configuration parameter |
| networkPolicy.ingressFrom | array | - | Chart configuration parameter |
| networkPolicy.egress | array | - | Chart configuration parameter |
Priority Class Name(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| priorityClassName | string | - | Priority class name |
Pod Labels(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| podLabels | object | - | Labels added to the main Flowise pod |
Pod Annotations(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| podAnnotations | object | - | Annotations added to the main Flowise pod |
Node Selector(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| nodeSelector | object | - | Node selector for pod scheduling |
Tolerations(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| tolerations | array | - | Tolerations for pod scheduling |
Affinity(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| affinity | object | - | Affinity rules for pod scheduling |
Extra Volume Mounts(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| extraVolumeMounts | array | - | Additional volume mounts for the main Flowise container |
Extra Volumes(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| extraVolumes | array | - | Additional volumes for the Flowise pods |
Extra Manifests(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| extraManifests | array | - | Extra Kubernetes manifests to deploy alongside the chart |
Backup(29)
| Parameter | Type | Default | Description |
|---|---|---|---|
| backup.enabled | boolean | - | Enable scheduled PostgreSQL backups to S3-compatible storage |
| backup.schedule | string | - | Cron schedule for backups (default: daily at 03:00 UTC) |
| backup.suspend | boolean | - | Suspend the CronJob without deleting it |
| backup.concurrencyPolicy | string | - | Concurrency policy: Forbid, Replace, Allow Allowed: ForbidReplaceAllow |
| backup.successfulJobsHistoryLimit | integer | - | Number of successful job records to keep |
| backup.failedJobsHistoryLimit | integer | - | Number of failed job records to keep |
| backup.backoffLimit | integer | - | Maximum retries per backup job |
| backup.archivePrefix | string | - | Prefix for backup archive filenames |
| backup.images.postgresql | string | - | Image used for PostgreSQL backup (must have pg_dump) |
| backup.images.uploader | string | - | Image used for S3 upload (MinIO client) |
| backup.resources | object | - | Resources for backup containers |
| backup.podSecurityContext.runAsNonRoot | boolean | - | Chart configuration parameter |
| backup.podSecurityContext.runAsUser | integer | - | Chart configuration parameter |
| backup.podSecurityContext.runAsGroup | integer | - | Chart configuration parameter |
| backup.podSecurityContext.fsGroup | integer | - | Chart configuration parameter |
| backup.podSecurityContext.seccompProfile.type | string | - | Chart configuration parameter Allowed: RuntimeDefaultLocalhostUnconfined |
| backup.securityContext.allowPrivilegeEscalation | boolean | - | Chart configuration parameter |
| backup.securityContext.readOnlyRootFilesystem | boolean | - | Chart configuration parameter |
| backup.securityContext.capabilities.drop | array | - | Chart configuration parameter |
| backup.database.pgDumpArgs | any | - | Extra pg_dump arguments. Arrays are preferred; legacy space-delimited strings remain accepted for upgrade compatibility. |
| backup.s3.endpoint | string | - | S3-compatible endpoint URL |
| backup.s3.bucket | string | - | Target bucket name |
| backup.s3.prefix | string | - | Key prefix within the bucket |
| backup.s3.createBucketIfNotExists | boolean | - | Auto-create the bucket if it does not exist |
| backup.s3.existingSecret | string | - | Use an existing secret for S3 credentials |
| backup.s3.existingSecretAccessKeyKey | string | - | Key in the existing secret for the access key |
| backup.s3.existingSecretSecretKeyKey | string | - | Key in the existing secret for the secret key |
| backup.s3.accessKey | string | - | Inline S3 access key (ignored when existingSecret is set) |
| backup.s3.secretKey | string | - | Inline S3 secret key (ignored when existingSecret is set) |
Gateway(6)
| Parameter | Type | Default | Description |
|---|---|---|---|
| gateway.enabled | boolean | false | Chart configuration parameter |
| gateway.annotations | object | - | Chart configuration parameter |
| gateway.parentRefs | array | - | Chart configuration parameter |
| gateway.hostnames | array | - | Chart configuration parameter |
| gateway.path | string | / | Chart configuration parameter |
| gateway.pathType | string | PathPrefix | Chart configuration parameter Allowed: PathPrefixExactRegularExpression |
External Secrets(7)
| Parameter | Type | Default | Description |
|---|---|---|---|
| externalSecrets.enabled | boolean | false | Chart configuration parameter |
| externalSecrets.apiVersion | string | external-secrets.io/v1 | Chart configuration parameter |
| externalSecrets.refreshInterval | string | 1h | Chart configuration parameter |
| externalSecrets.secretStoreRef.name | string | - | Chart configuration parameter |
| externalSecrets.secretStoreRef.kind | string | - | Chart configuration parameter |
| externalSecrets.target.creationPolicy | string | - | Chart configuration parameter |
| externalSecrets.data | array | - | Chart configuration parameter |
No schema parameters match your search
Try searching for a different keyword or reset the filter.