FlowiseAI
English
English
  • Introduction
  • Get Started
  • Contribution Guide
    • Building Node
  • API Reference
    • Assistants
    • Attachments
    • Chat Message
    • Chatflows
    • Document Store
    • Feedback
    • Leads
    • Ping
    • Prediction
    • Tools
    • Upsert History
    • Variables
    • Vector Upsert
  • CLI Reference
    • User
  • Using Flowise
    • Agentflow V2
    • Agentflow V1 (Deprecating)
      • Multi-Agents
      • Sequential Agents
        • Video Tutorials
    • API
    • Analytic
      • Arize
      • Langfuse
      • Lunary
      • Opik
      • Phoenix
    • Document Stores
    • Embed
    • Monitoring
    • Streaming
    • Uploads
    • Variables
    • Workspaces
    • Evaluations
  • Configuration
    • Auth
      • Application
      • Flows
    • Databases
    • Deployment
      • AWS
      • Azure
      • Alibaba Cloud
      • Digital Ocean
      • Elestio
      • GCP
      • Hugging Face
      • Kubernetes using Helm
      • Railway
      • Render
      • Replit
      • RepoCloud
      • Sealos
      • Zeabur
    • Environment Variables
    • Rate Limit
    • Running Flowise behind company proxy
    • SSO
    • Running Flowise using Queue
    • Running in Production
  • Integrations
    • LangChain
      • Agents
        • Airtable Agent
        • AutoGPT
        • BabyAGI
        • CSV Agent
        • Conversational Agent
        • Conversational Retrieval Agent
        • MistralAI Tool Agent
        • OpenAI Assistant
          • Threads
        • OpenAI Function Agent
        • OpenAI Tool Agent
        • ReAct Agent Chat
        • ReAct Agent LLM
        • Tool Agent
        • XML Agent
      • Cache
        • InMemory Cache
        • InMemory Embedding Cache
        • Momento Cache
        • Redis Cache
        • Redis Embeddings Cache
        • Upstash Redis Cache
      • Chains
        • GET API Chain
        • OpenAPI Chain
        • POST API Chain
        • Conversation Chain
        • Conversational Retrieval QA Chain
        • LLM Chain
        • Multi Prompt Chain
        • Multi Retrieval QA Chain
        • Retrieval QA Chain
        • Sql Database Chain
        • Vectara QA Chain
        • VectorDB QA Chain
      • Chat Models
        • AWS ChatBedrock
        • Azure ChatOpenAI
        • NVIDIA NIM
        • ChatAnthropic
        • ChatCohere
        • Chat Fireworks
        • ChatGoogleGenerativeAI
        • Google VertexAI
        • ChatHuggingFace
        • ChatLocalAI
        • ChatMistralAI
        • IBM Watsonx
        • ChatOllama
        • ChatOpenAI
        • ChatTogetherAI
        • GroqChat
      • Document Loaders
        • Airtable
        • API Loader
        • Apify Website Content Crawler
        • BraveSearch Loader
        • Cheerio Web Scraper
        • Confluence
        • Csv File
        • Custom Document Loader
        • Document Store
        • Docx File
        • Epub File
        • Figma
        • File
        • FireCrawl
        • Folder
        • GitBook
        • Github
        • Google Drive
        • Google Sheets
        • Jira
        • Json File
        • Json Lines File
        • Microsoft Excel
        • Microsoft Powerpoint
        • Microsoft Word
        • Notion
        • PDF Files
        • Plain Text
        • Playwright Web Scraper
        • Puppeteer Web Scraper
        • S3 File Loader
        • SearchApi For Web Search
        • SerpApi For Web Search
        • Spider - web search & crawler
        • Text File
        • Unstructured File Loader
        • Unstructured Folder Loader
      • Embeddings
        • AWS Bedrock Embeddings
        • Azure OpenAI Embeddings
        • Cohere Embeddings
        • Google GenerativeAI Embeddings
        • Google VertexAI Embeddings
        • HuggingFace Inference Embeddings
        • LocalAI Embeddings
        • MistralAI Embeddings
        • Ollama Embeddings
        • OpenAI Embeddings
        • OpenAI Embeddings Custom
        • TogetherAI Embedding
        • VoyageAI Embeddings
      • LLMs
        • AWS Bedrock
        • Azure OpenAI
        • Cohere
        • GoogleVertex AI
        • HuggingFace Inference
        • Ollama
        • OpenAI
        • Replicate
      • Memory
        • Buffer Memory
        • Buffer Window Memory
        • Conversation Summary Memory
        • Conversation Summary Buffer Memory
        • DynamoDB Chat Memory
        • MongoDB Atlas Chat Memory
        • Redis-Backed Chat Memory
        • Upstash Redis-Backed Chat Memory
        • Zep Memory
      • Moderation
        • OpenAI Moderation
        • Simple Prompt Moderation
      • Output Parsers
        • CSV Output Parser
        • Custom List Output Parser
        • Structured Output Parser
        • Advanced Structured Output Parser
      • Prompts
        • Chat Prompt Template
        • Few Shot Prompt Template
        • Prompt Template
      • Record Managers
      • Retrievers
        • Extract Metadata Retriever
        • Custom Retriever
        • Cohere Rerank Retriever
        • Embeddings Filter Retriever
        • HyDE Retriever
        • LLM Filter Retriever
        • Multi Query Retriever
        • Prompt Retriever
        • Reciprocal Rank Fusion Retriever
        • Similarity Score Threshold Retriever
        • Vector Store Retriever
        • Voyage AI Rerank Retriever
      • Text Splitters
        • Character Text Splitter
        • Code Text Splitter
        • Html-To-Markdown Text Splitter
        • Markdown Text Splitter
        • Recursive Character Text Splitter
        • Token Text Splitter
      • Tools
        • BraveSearch API
        • Calculator
        • Chain Tool
        • Chatflow Tool
        • Custom Tool
        • Exa Search
        • Gmail
        • Google Calendar
        • Google Custom Search
        • Google Drive
        • Google Sheets
        • Microsoft Outlook
        • Microsoft Teams
        • OpenAPI Toolkit
        • Code Interpreter by E2B
        • Read File
        • Request Get
        • Request Post
        • Retriever Tool
        • SearchApi
        • SearXNG
        • Serp API
        • Serper
        • Tavily
        • Web Browser
        • Write File
      • Vector Stores
        • AstraDB
        • Chroma
        • Couchbase
        • Elastic
        • Faiss
        • In-Memory Vector Store
        • Milvus
        • MongoDB Atlas
        • OpenSearch
        • Pinecone
        • Postgres
        • Qdrant
        • Redis
        • SingleStore
        • Supabase
        • Upstash Vector
        • Vectara
        • Weaviate
        • Zep Collection - Open Source
        • Zep Collection - Cloud
    • LiteLLM Proxy
    • LlamaIndex
      • Agents
        • OpenAI Tool Agent
        • Anthropic Tool Agent
      • Chat Models
        • AzureChatOpenAI
        • ChatAnthropic
        • ChatMistral
        • ChatOllama
        • ChatOpenAI
        • ChatTogetherAI
        • ChatGroq
      • Embeddings
        • Azure OpenAI Embeddings
        • OpenAI Embedding
      • Engine
        • Query Engine
        • Simple Chat Engine
        • Context Chat Engine
        • Sub-Question Query Engine
      • Response Synthesizer
        • Refine
        • Compact And Refine
        • Simple Response Builder
        • Tree Summarize
      • Tools
        • Query Engine Tool
      • Vector Stores
        • Pinecone
        • SimpleStore
    • Utilities
      • Custom JS Function
      • Set/Get Variable
      • If Else
      • Sticky Note
    • External Integrations
      • Zapier Zaps
  • Migration Guide
    • Cloud Migration
    • v1.3.0 Migration Guide
    • v1.4.3 Migration Guide
    • v2.1.4 Migration Guide
  • Tutorials
    • RAG
    • Agentic RAG
    • SQL Agent
    • Agent as Tool
    • Interacting with API
    • Tools & MCP
    • Structured Output
    • Human In The Loop
    • Deep Research
  • Use Cases
    • Calling Children Flows
    • Calling Webhook
    • Interacting with API
    • Multiple Documents QnA
    • SQL QnA
    • Upserting Data
    • Web Scrape QnA
  • Flowise
    • Flowise GitHub
    • Flowise Cloud
Powered by GitBook
On this page
  • For Database
  • For Storage
  • For Debugging and Logs
  • Logs Streaming S3
  • Logs Streaming GCS
  • For Credentials
  • For Models
  • For API Keys (Deprecated)
  • For Built-In and External Dependencies
  • Examples of how to set environment variables
  • NPM
  • Docker
  • Docker Compose
Edit on GitHub
  1. Configuration

Environment Variables

Learn how to configure environment variables for Flowise

PreviousZeaburNextRate Limit

Last updated 19 days ago

Flowise support different environment variables to configure your instance. You can specify the following variables in the .env file inside packages/server folder. Refer to file.

Variable
Description
Type
Default

PORT

The HTTP port Flowise runs on

Number

3000

FLOWISE_FILE_SIZE_LIMIT

Maximum file size when uploading

String

50mb

NUMBER_OF_PROXIES

Rate Limit Proxy

Number

CORS_ORIGINS

The allowed origins for all cross-origin HTTP calls

String

IFRAME_ORIGINS

The allowed origins for iframe src embedding

String

SHOW_COMMUNITY_NODES

Display nodes that are created by community

Boolean: true or false

DISABLED_NODES

Comma separated list of node names to disable

String

For Database

Variable
Description
Type
Default

DATABASE_TYPE

Type of database to store the flowise data

Enum String: sqlite, mysql, postgres

sqlite

DATABASE_PATH

Location where database is saved (When DATABASE_TYPE is sqlite)

String

your-home-dir/.flowise

DATABASE_HOST

Host URL or IP address (When DATABASE_TYPE is not sqlite)

String

DATABASE_PORT

Database port (When DATABASE_TYPE is not sqlite)

String

DATABASE_USER

Database username (When DATABASE_TYPE is not sqlite)

String

DATABASE_PASSWORD

Database password (When DATABASE_TYPE is not sqlite)

String

DATABASE_NAME

Database name (When DATABASE_TYPE is not sqlite)

String

DATABASE_SSL

Database SSL is required (When DATABASE_TYPE is not sqlite)

Boolean: true or false

false

For Storage

Flowise store the following files under a local path folder by default.

  • Image/Audio uploads from chat

  • Images/Files from Assistant

User can specify STORAGE_TYPE to use AWS S3, Google Cloud Storage or local path

Variable
Description
Type
Default

STORAGE_TYPE

Type of storage for uploaded files. default is local

Enum String: s3, gcs, local

local

BLOB_STORAGE_PATH

Local folder path where uploaded files are stored when STORAGE_TYPE is local

String

your-home-dir/.flowise/storage

S3_STORAGE_BUCKET_NAME

Bucket name to hold the uploaded files when STORAGE_TYPE is s3

String

S3_STORAGE_ACCESS_KEY_ID

AWS Access Key

String

S3_STORAGE_SECRET_ACCESS_KEY

AWS Secret Key

String

S3_STORAGE_REGION

Region for S3 bucket

String

S3_ENDPOINT_URL

Custom S3 endpoint (optional)

String

S3_FORCE_PATH_STYLE

Force S3 path style (optional)

Boolean

false

GOOGLE_CLOUD_STORAGE_CREDENTIAL

Google Cloud Service Account Key

String

GOOGLE_CLOUD_STORAGE_PROJ_ID

Google Cloud Project ID

String

GOOGLE_CLOUD_STORAGE_BUCKET_NAME

Google Cloud Storage Bucket Name

String

GOOGLE_CLOUD_UNIFORM_BUCKET_ACCESS

Type of Access

Boolean

true

For Debugging and Logs

Variable
Description
Type

DEBUG

Print logs from components

Boolean

LOG_PATH

Location where log files are stored

String

Flowise/packages/server/logs

LOG_LEVEL

Different levels of logs

Enum String: error, info, verbose, debug

info

DEBUG: if set to true, will print logs to terminal/console:

LOG_LEVEL: Different log levels for loggers to be saved. Can be error, info, verbose, or debug. By default it is set to info, only logger.info will be saved to the log files. If you want to have complete details, set to debug.

Logs Streaming S3

When STORAGE_TYPE env variable is set to s3 , logs will be automatically streamed and stored to S3. New log file will be created hourly, enabling easier debugging.

Logs Streaming GCS

For Credentials

Flowise store your third party API keys as encrypted credentials using an encryption key.

By default, a random encryption key will be generated when starting up the application and stored under a file path. This encryption key is then retrieved everytime to decrypt the credentials used within a chatflow. For example, your OpenAI API key, Pinecone API key, etc.

You can configure to use AWS Secret Manager to store the encryption key instead.

Variable
Description
Type
Default

SECRETKEY_STORAGE_TYPE

How to store the encryption key

Enum String: local, aws

local

SECRETKEY_PATH

Local file path where encryption key is saved

String

Flowise/packages/server

FLOWISE_SECRETKEY_OVERWRITE

Encryption key to be used instead of the existing key

String

SECRETKEY_AWS_ACCESS_KEY

String

SECRETKEY_AWS_SECRET_KEY

String

SECRETKEY_AWS_REGION

String

For some reasons, sometimes encryption key might be re-generated or the stored path was changed, this will cause errors like - Credentials could not be decrypted.

To avoid this, you can set your own encryption key as FLOWISE_SECRETKEY_OVERWRITE, so that the same encryption key will be used everytime. There is no restriction on the format, you can set it as any text that you want, or the same as your FLOWISE_PASSWORD.

Credential API Key returned from the UI is not the same length as your original Api Key that you have set. This is a fake prefix string that prevents network spoofing, that's why we are not returning the Api Key back to UI. However, the correct Api Key will be retrieved and used during your interaction with the chatflow.

For Models

In some cases, you might want to use custom model on the existing Chat Model and LLM nodes, or restrict access to only certain models.

Variable
Description
Type
Default

MODEL_LIST_CONFIG_JSON

Link to load list of models from your models.json config file

String

For API Keys (Deprecated)

Variable
Description
Type
Default

APIKEY_STORAGE_TYPE

Method to store API keys

Enum string: json, db

json

APIKEY_PATH

Location where the API keys are stored when APIKEY_STORAGE_TYPE is unspecified or json

String

Flowise/packages/server

Using db as storage type will store the API keys to database instead of a local JSON file.

For Built-In and External Dependencies

There are certain nodes/features within Flowise that allow user to run Javascript code. For security reasons, by default it only allow certain dependencies. It's possible to lift that restriction for built-in and external modules by setting the following environment variables:

Variable
Description

TOOL_FUNCTION_BUILTIN_DEP

NodeJS built-in modules to be used for Tool Function

String

TOOL_FUNCTION_EXTERNAL_DEP

External modules to be used for Tool Function

String

.env
# Allows usage of all builtin modules
TOOL_FUNCTION_BUILTIN_DEP=*

# Allows usage of only fs
TOOL_FUNCTION_BUILTIN_DEP=fs

# Allows usage of only crypto and fs
TOOL_FUNCTION_BUILTIN_DEP=crypto,fs

# Allow usage of external npm modules.
TOOL_FUNCTION_EXTERNAL_DEP=axios,moment

Examples of how to set environment variables

NPM

You can set all these variables when running Flowise using npx. For example:

npx flowise start --PORT=3000 --DEBUG=true

Docker

docker run -d -p 5678:5678 flowise \
 -e DATABASE_TYPE=postgresdb \
 -e DATABASE_PORT=<POSTGRES_PORT> \
 -e DATABASE_HOST=<POSTGRES_HOST> \
 -e DATABASE_NAME=<POSTGRES_DATABASE_NAME> \
 -e DATABASE_USER=<POSTGRES_USER> \
 -e DATABASE_PASSWORD=<POSTGRES_PASSWORD> \

Docker Compose

Files uploaded on /Document Store

Files from

When STORAGE_TYPE env variable is set to gcs , logs will be automatically streamed to Google .

By default, Flowise pulls the model list from . However user can create their own models.json file and specify the file path:

Users can create multiple API keys within Flowise in order to authenticate with the . By default, keys get stored as a JSON file to your local file path. User can change the behavior by using the below env variable.

You can set all these variables in the .env file inside docker folder. Refer to file.

.env.example
Document Loaders
Vector Upsert API
Cloud Logging
here
APIs
.env.example
https://raw.githubusercontent.com/FlowiseAI/Flowise/main/packages/components/models.json
server-requests.log.jsonl - logs every request sent to Flowise
server.log - logs general actions on Flowise
server-error.log - logs error with stack trace
Flowise API Keys