Variables de Entorno

Aprende cómo configurar las environment variables para Flowise

Flowise soporta diferentes environment variables para configurar tu instancia. Puedes especificar las siguientes variables en el archivo .env dentro de la carpeta packages/server. Consulta el archivo .env.example.

Variable	Descripción	Type	Default
PORT	El puerto HTTP en el que se ejecuta Flowise	Number	3000
FLOWISE_USERNAME	Username para iniciar sesión	String
FLOWISE_PASSWORD	Password para iniciar sesión	String
FLOWISE_FILE_SIZE_LIMIT	Tamaño máximo de archivo al subir	String	50mb
NUMBER_OF_PROXIES	Rate Limit Proxy	Number
CORS_ORIGINS	Los orígenes permitidos para todas las llamadas HTTP cross-origin	String
IFRAME_ORIGINS	Los orígenes permitidos para incrustar en iframe src	String
DISABLE_CHATFLOW_REUSE	Deshabilita el cacheo del flow, permitiendo que cada interacción del chatflow se ejecute desde cero	Boolean: true o false
SHOW_COMMUNITY_NODES	Muestra los nodes creados por la comunidad	Boolean: true o false

Para Database

Variable	Descripción	Type	Default
DATABASE_TYPE	Tipo de database para almacenar los datos de flowise	Enum String: sqlite, mysql, postgres	sqlite
DATABASE_PATH	Ubicación donde se guarda la database (Cuando DATABASE_TYPE es sqlite)	String	your-home-dir/.flowise
DATABASE_HOST	Host URL o dirección IP (Cuando DATABASE_TYPE no es sqlite)	String
DATABASE_PORT	Puerto de la database (Cuando DATABASE_TYPE no es sqlite)	String
DATABASE_USER	Username de la database (Cuando DATABASE_TYPE no es sqlite)	String
DATABASE_PASSWORD	Password de la database (Cuando DATABASE_TYPE no es sqlite)	String
DATABASE_NAME	Nombre de la database (Cuando DATABASE_TYPE no es sqlite)	String
DATABASE_SSL	SSL de la database es requerido (Cuando DATABASE_TYPE no es sqlite)	Boolean: true o false	false

Para LangSmith Tracing

Flowise soporta LangSmith tracing con las siguientes env variables:

Variable	Descripción	Type
LANGCHAIN_TRACING_V2	Activa o desactiva LangSmith tracing	Enum String: true, false
LANGCHAIN_ENDPOINT	LangSmith endpoint	String
LANGCHAIN_API_KEY	LangSmith API Key	String
LANGCHAIN_PROJECT	Project para hacer trace en LangSmith	String

Mira cómo conectar Flowise y LangSmith

Para Built-In y External Dependencies

Por razones de seguridad, por defecto Tool Function solo permite ciertas dependencies. Es posible levantar esa restricción para módulos built-in y externos configurando las siguientes environment variables:

Variable	Descripción
TOOL_FUNCTION_BUILTIN_DEP	Módulos built-in de NodeJS para usar en Tool Function	String
TOOL_FUNCTION_EXTERNAL_DEP	Módulos externos para usar en Tool Function	String

.env

# Permite el uso de todos los módulos builtin
TOOL_FUNCTION_BUILTIN_DEP=*

# Permite el uso de solo fs
TOOL_FUNCTION_BUILTIN_DEP=fs

# Permite el uso de solo crypto y fs
TOOL_FUNCTION_BUILTIN_DEP=crypto,fs

# Permite el uso de módulos npm externos
TOOL_FUNCTION_EXTERNAL_DEP=axios,moment

Para Debugging y Logs

Variable	Descripción	Type
DEBUG	Imprime logs de los componentes	Boolean
LOG_PATH	Ubicación donde se guardan los archivos de log	String	Flowise/packages/server/logs
LOG_LEVEL	Diferentes niveles de logs	Enum String: error, info, verbose, debug	info

DEBUG: si se establece en true, imprimirá logs en la terminal/consola:

LOG_LEVEL: Diferentes niveles de log para los loggers que se guardarán. Puede ser error, info, verbose, o debug. Por defecto está establecido en info, solo logger.info se guardará en los archivos de log. Si quieres tener detalles completos, establécelo en debug.

server-requests.log.jsonl - registra cada request enviada a Flowise

server.log - registra acciones generales en Flowise

server-error.log - registra errores con stack trace

Para Credentials

Flowise almacena tus API keys de terceros como credentials encriptadas usando una encryption key.

Por defecto, se generará una random encryption key al iniciar la aplicación y se almacenará en una ruta de archivo. Esta encryption key se recupera cada vez para descifrar las credentials utilizadas dentro de un chatflow. Por ejemplo, tu OpenAI API key, Pinecone API key, etc.

Variable	Descripción	Type
SECRETKEY_PATH	Ubicación donde se guarda la encryption key (usada para encriptar/desencriptar credentials)	String	Flowise/packages/server
FLOWISE_SECRETKEY_OVERWRITE	Encryption key a usar en lugar de la key almacenada en SECRETKEY_PATH	String

Por algunas razones, a veces la encryption key podría regenerarse o la ruta almacenada cambió, esto causará errores como - Credentials could not be decrypted.

Para evitar esto, puedes establecer tu propia encryption key como FLOWISE_SECRETKEY_OVERWRITE, así la misma encryption key se usará cada vez. No hay restricción en el formato, puedes establecerla como cualquier texto que desees, o la misma que tu FLOWISE_PASSWORD.

La Credential API Key devuelta desde la UI no tiene la misma longitud que tu Api Key original que has establecido. Este es un prefijo de cadena falso que previene el spoofing de red, por eso no devolvemos la Api Key a la UI. Sin embargo, la Api Key correcta será recuperada y usada durante tu interacción con el chatflow.

Para Models

En algunos casos, podrías querer usar un modelo personalizado en los nodes existentes de Chat Model y LLM, o restringir el acceso a solo ciertos modelos.

Por defecto, Flowise obtiene la lista de modelos de aquí. Sin embargo, el usuario puede crear su propio archivo models.json y especificar la ruta del archivo:

Variable	Descripción	Type	Default
MODEL_LIST_CONFIG_JSON	Link para cargar la lista de modelos desde tu archivo de configuración models.json	String	https://raw.githubusercontent.com/FlowiseAI/Flowise/main/packages/components/models.json

Para Flowise API Keys

Por defecto, Flowise almacena tus API keys (no Credentials) que pueden usarse para interactuar con API Reference en una ruta de archivo local. El usuario puede cambiar el comportamiento usando la variable env de abajo.

Variable	Descripción	Type	Default
APIKEY_STORAGE_TYPE	Método para almacenar API keys	Enum string: json, db	json
APIKEY_PATH	Ubicación donde se almacenan las API keys cuando APIKEY_STORAGE_TYPE no está especificado o es json	String	Flowise/packages/server

Usar db como tipo de almacenamiento guardará las API keys en la database en lugar de un archivo JSON local.

Para Storage

Flowise almacena los siguientes archivos bajo una carpeta de ruta local por defecto.

• Archivos subidos en Document Loaders/Document Store

• Subidas de imagen/audio desde el chat

• Imágenes/Archivos desde Assistant

• Archivos desde Vector Upsert API

El usuario puede especificar STORAGE_TYPE para usar AWS S3 o ruta local

Variable	Descripción	Type	Default
STORAGE_TYPE	Tipo de almacenamiento para archivos subidos. por defecto es local	Enum String: s3, local	local
BLOB_STORAGE_PATH	Ruta de carpeta local donde se almacenan los archivos subidos cuando STORAGE_TYPE es local	String	your-home-dir/.flowise/storage
S3_STORAGE_BUCKET_NAME	Nombre del bucket para contener los archivos subidos cuando STORAGE_TYPE es s3	String
S3_STORAGE_ACCESS_KEY_ID	AWS Access Key	String
S3_STORAGE_SECRET_ACCESS_KEY	AWS Secret Key	String
S3_STORAGE_REGION	Region para el bucket S3	String

Ejemplos de cómo establecer environment variables:

NPM

Puedes establecer todas estas variables al ejecutar Flowise usando npx. Por ejemplo:

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

Puedes establecer todas estas variables en el archivo .env dentro de la carpeta docker. Consulta el archivo .env.example.