You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This document provides detailed descriptions of the environment variables required by the system, including middleware, service ports, authentication, access addresses, and more. Business capability accounts such as iFLYTEK Open Platform, AI Ability Chat, Virtual Man, and Knowledge Base Platform have moved to the console Platform Account Management page and are no longer written to .env.
Quick Start
Required Manual Configuration Fields
Before deploying with Docker Compose, the following environment variables must be manually configured. For detailed configuration steps and instructions, please refer to the Deployment Guide.
Key Configuration Items Overview:
Casdoor Authentication Configuration (requires Casdoor service deployment):
CONSOLE_CASDOOR_URL, CONSOLE_CASDOOR_ID
CONSOLE_CASDOOR_APP, CONSOLE_CASDOOR_ORG
Host Address Configuration:
HOST_BASE_ADDRESS - Set to your server address or domain name
Business capability accounts configured after startup in Platform Account Management (not written to .env):
iFLYTEK Open Platform: PLATFORM_APP_ID, PLATFORM_API_KEY, PLATFORM_API_SECRET, SPARK_API_PASSWORD, SPARK_RTASR_API_KEY
AI Ability Chat: AI_ABILITY_CHAT_BASE_URL, AI_ABILITY_CHAT_MODEL, AI_ABILITY_CHAT_API_KEY
Virtual Man capability: SPARK_VIRTUAL_MAN_APP_ID, SPARK_VIRTUAL_MAN_API_KEY, SPARK_VIRTUAL_MAN_API_SECRET
Knowledge Base Platform: RAGFlow fields RAGFLOW_BASE_URL, RAGFLOW_API_TOKEN, RAGFLOW_TIMEOUT, RAGFLOW_DEFAULT_GROUP, and Spark Knowledge Base field XINGHUO_DATASET_ID
Configuration Item Descriptions
Configuration items in this document are marked as follows:
User Required: Fields that must be manually configured (no default value or require external service application)
Use Default: Recommended to use the default configuration provided by Docker Compose (modify if using external middleware)
Required: Must exist but default value is provided (usually no modification needed)
Optional: Non-essential configuration, can be enabled as needed
Conditional: Fields that need to be configured only in specific scenarios
1. Middleware Configuration Module
Independent Deployment Note:
If using Docker Compose one-click deployment, the following configurations can use container names (such as postgres, mysql, redis, kafka, minio) as host addresses
If middleware services are deployed separately (not in the same Docker network), you need to replace the container names in the following configurations with actual IP addresses or domain names, and synchronize the corresponding connection information (such as username, password, port, etc.):
PostgreSQL related: POSTGRES_HOST, POSTGRES_USER, POSTGRES_PASSWORD, POSTGRES_PORT, etc.
MySQL related: MYSQL_HOST, MYSQL_USER, MYSQL_PASSWORD, MYSQL_URL, etc.
Redis related: REDIS_ADDR, REDIS_HOST, REDIS_PASSWORD, REDIS_PORT, etc.
Kafka related: KAFKA_SERVERS and authentication information (if needed)
MinIO related: OSS_ENDPOINT, OSS_DOWNLOAD_HOST, OSS_ACCESS_KEY_ID, OSS_SECRET_KEY, etc.
Variable Name
Configuration Type
Type
Description
Example Value
POSTGRES_USER
Use Default
string
PostgreSQL database username
spark
POSTGRES_PASSWORD
Use Default
string
PostgreSQL database password
spark123
POSTGRES_HOST
Use Default
string
PostgreSQL database host address
postgres
POSTGRES_PORT
Use Default
int
PostgreSQL database port number
5432
MYSQL_ROOT_PASSWORD
Use Default
string
MySQL database root user password
root123
MYSQL_USER
Use Default
string
MySQL database username
root
MYSQL_PASSWORD
Use Default
string
MySQL database password (defaults from MYSQL_ROOT_PASSWORD)
root123
MYSQL_HOST
Use Default
string
MySQL database host address
mysql
MYSQL_PORT
Use Default
int
MySQL database port number
3306
MYSQL_URL
Use Default
string
MySQL database JDBC connection URL
jdbc:mysql://mysql:3306/astron_console
REDIS_PASSWORD
Optional
string
Redis password (empty means no password)
(empty)
REDIS_DATABASE
Use Default
int
Redis database index (0-15)
0
REDIS_IS_CLUSTER
Use Default
bool
Whether Redis is in cluster mode
false
REDIS_CLUSTER_ADDR
Optional
string
Redis cluster address (used in cluster mode)
redis1:6379,redis2:6379
REDIS_EXPIRE
Use Default
int
Redis cache expiration time (seconds)
3600
REDIS_ADDR
Use Default
string
Redis connection address (standalone mode)
redis:6379
REDIS_HOST
Use Default
string
Redis host address
redis
REDIS_PORT
Use Default
int
Redis port number
6379
ELASTICSEARCH_SECURITY_ENABLED
Use Default
bool
Whether Elasticsearch has security authentication enabled
Application authentication service host address (port defaults from CORE_TENANT_PORT)
core-tenant:${CORE_TENANT_PORT:-5052}
APP_AUTH_PROT
Required
string
Application authentication service protocol (http/https)
http
APP_AUTH_API_KEY
Required
string
Application authentication API Key
7b709739e8da44536127a333c7603a83
APP_AUTH_SECRET
Required
string
Application authentication Secret
NjhmY2NmM2NkZDE4MDFlNmM5ZjcyZjMy
10. Knowledge Module Configuration
Knowledge Base Selection Note: The system supports two knowledge base methods. Choose one when creating a knowledge base:
RAGFlow: Use RAGFlow knowledge base service
Spark Knowledge Base: Use iFLYTEK Spark Knowledge Base service
Knowledge platform accounts are no longer configured through .env. Fill in the corresponding fields under Platform Account Management - Knowledge Base Platform in the console. After saving, the configuration takes effect globally without restarting containers. Whichever method you choose, the corresponding configuration items are required; configuration items for the unchosen method can be left empty.
Field
Platform
Configuration Type
Description
Example Value
RAGFLOW_BASE_URL
RAGFlow
Conditional
RAGFlow service base address (required when using RAGFlow)