Guide to configuring Flowise for optimal performance and use cases.
| Platform |
Location |
| Docker |
/root/.flowise |
| NPM |
~/.flowise |
| Custom |
Defined by DATABASE_PATH |
| Database |
Configuration |
| SQLite |
DATABASE_TYPE=sqlite |
| PostgreSQL |
DATABASE_TYPE=postgres |
| MySQL |
DATABASE_TYPE=mysql |
| Variable |
Description |
Default |
PORT |
API server port |
3000 |
DATABASE_TYPE |
Database type |
sqlite |
SQLite:
| Variable |
Description |
Default |
DATABASE_PATH |
SQLite database path |
~/.flowise/database.sqlite |
PostgreSQL:
| Variable |
Description |
Example |
DATABASE_HOST |
PostgreSQL host |
localhost |
DATABASE_PORT |
PostgreSQL port |
5432 |
DATABASE_NAME |
Database name |
flowise |
DATABASE_USER |
Database user |
flowise |
DATABASE_PASSWORD |
Database password |
secure-password |
MySQL:
| Variable |
Description |
Example |
DATABASE_HOST |
MySQL host |
localhost |
DATABASE_PORT |
MySQL port |
3306 |
DATABASE_NAME |
Database name |
flowise |
DATABASE_USER |
Database user |
flowise |
DATABASE_PASSWORD |
Database password |
secure-password |
| Variable |
Description |
Default |
DISABLE_TELEMETRY |
Disable telemetry |
false |
BASIC_AUTH_USERNAME |
Basic auth username |
- |
BASIC_AUTH_PASSWORD |
Basic auth password |
- |
STORAGE_TYPE |
Storage type |
local |
STORAGE_PATH |
Storage path |
~/.flowise/storage |
REDIS_HOST |
Redis host |
localhost |
REDIS_PORT |
Redis port |
6379 |
REDIS_PASSWORD |
Redis password |
- |
LOG_LEVEL |
Logging level |
info |
CORS_ORIGINS |
CORS allowed origins |
* |
- Click “Create New Flow”
- Name your flow
- Drag and drop nodes from sidebar
- Connect nodes together
- Click “Save”
| Setting |
Description |
| Name |
Flow display name |
| Description |
Flow description |
| Category |
Flow category |
| Tags |
Flow tags for organization |
| Node |
Configuration |
| ChatOpenAI |
API key, model, temperature |
| ChatAnthropic |
API key, model, temperature |
| ChatOllama |
Base URL, model, temperature |
| ChatGoogleVertexAI |
Credentials, project, location |
| Node |
Configuration |
| Pinecone |
API key, environment, index |
| Chroma |
Path or URL |
| FAISS |
Path for local storage |
| Weaviate |
URL, API key |
| Tool |
Configuration |
| Calculator |
None |
| Wolfram Alpha |
App ID |
| SerpAPI |
API key |
| Custom Tool |
Name, description, function |
Generate API Key:
- Go to Settings → API Keys
- Click “Create API Key”
- Name your key
- Copy and store securely
| Endpoint |
Method |
Purpose |
/api/v1/prediction/{chatflowId} |
POST |
Create prediction |
/api/v1/chatflows |
GET/POST |
List/create flows |
/api/v1/nodes |
GET |
List available nodes |
/api/v1/components |
GET |
List available components |
curl http://localhost:3000/api/v1/prediction/{chatflowId} \
-H "Content-Type: application/json" \
-d '{
"question": "What is the capital of France?"
}'
# In .env or docker-compose.yml
BASIC_AUTH_USERNAME=admin
BASIC_AUTH_PASSWORD=secure-password
Include API key in requests:
curl http://localhost:3000/api/v1/prediction/{chatflowId} \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"question": "Hello!"}'
STORAGE_TYPE=local
STORAGE_PATH=/path/to/storage
STORAGE_TYPE=s3
S3_BUCKET_NAME=your-bucket
S3_ACCESS_KEY_ID=your-access-key
S3_SECRET_ACCESS_KEY=your-secret-key
S3_REGION=us-east-1
REDIS_HOST=localhost
REDIS_PORT=6379
REDIS_PASSWORD=secure-password
services:
flowise:
environment:
- REDIS_HOST=redis
- REDIS_PORT=6379
- REDIS_PASSWORD=secure-password
redis:
image: redis:7-alpine
command: redis-server --requirepass secure-password
| Level |
Description |
error |
Only errors |
warn |
Warnings and errors |
info |
General information |
debug |
Detailed debugging |
LOG_LEVEL=info
# Enable Prometheus metrics
PROMETHEUS_ENABLED=true
PROMETHEUS_PORT=9090
OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317
OTEL_SERVICE_NAME=flowise
# Backup data directory
tar -czf flowise-backup.tar.gz ~/.flowise/
# Backup specific flows
# Export flows from UI
Cron Job:
# Daily backup at 2 AM
0 2 * * * tar -czf /backup/flowise-$(date +\%Y\%m\%d).tar.gz ~/.flowise/
| Issue |
Solution |
| Database connection failed |
Check DATABASE_* variables |
| Port already in use |
Change PORT variable |
| Memory issues |
Increase NODE_OPTIONS |
| Slow performance |
Enable Redis for scaling |
# Stop Flowise
npx flowise stop
# Backup current config
mv ~/.flowise ~/.flowise.backup
# Restart Flowise
npx flowise start
Any questions?
Feel free to contact us. Find all contact information on our contact page.