Configuration

Configuration Method

Glean is configured through environment variables. Create a .env file:

# Download example configuration
curl -fsSL https://raw.githubusercontent.com/LeslieLeung/glean/main/.env.example -o .env

# Edit configuration
nano .env

Core Configuration

Security Settings

Variable	Required	Default	Description
`SECRET_KEY`	Yes	-	JWT signing key, at least 32 characters
`DEBUG`	No	`false`	Debug mode, must be disabled in production

Database Configuration

Variable	Required	Default	Description
`POSTGRES_DB`	No	`glean`	Database name
`POSTGRES_USER`	No	`glean`	Database username
`POSTGRES_PASSWORD`	Yes	`glean`	Database password

Port Configuration

Variable	Default	Description
`WEB_PORT`	`80`	Web application port
`ADMIN_PORT`	`3001`	Admin dashboard port

Admin Configuration

Auto-create admin account on first startup:

Variable	Default	Description
`CREATE_ADMIN`	`false`	Whether to auto-create admin
`ADMIN_USERNAME`	`admin`	Admin username
`ADMIN_PASSWORD`	-	Admin password (required if enabled)
`ADMIN_ROLE`	`super_admin`	Admin role

Example configuration:

CREATE_ADMIN=true
ADMIN_USERNAME=admin
ADMIN_PASSWORD=MySecurePass123!

Logging Configuration

Variable	Default	Description
`LOG_LEVEL`	`INFO`	Log level (DEBUG/INFO/WARNING/ERROR)
`LOG_FILE`	`/app/logs/glean-api.log`	Log file path
`LOG_ROTATION`	`100 MB`	Log rotation size
`LOG_RETENTION`	`30 days`	Log retention period
`LOG_COMPRESSION`	`gz`	Log compression format

Milvus Configuration (Vector Database)

Milvus configuration for full deployment mode:

Variable	Default	Description
`MILVUS_HOST`	`milvus`	Milvus service host
`MILVUS_PORT`	`19530`	Milvus service port
`MILVUS_USER`	-	Milvus username (if auth enabled)
`MILVUS_PASSWORD`	-	Milvus password (if auth enabled)

Embedding Configuration

Vector embedding configuration for smart recommendations:

Variable	Default	Description
`EMBEDDING_PROVIDER`	`sentence-transformers`	Embedding provider
`EMBEDDING_MODEL`	`all-MiniLM-L6-v2`	Model name
`EMBEDDING_DIMENSION`	`384`	Vector dimension (must match model)
`EMBEDDING_API_KEY`	-	API key (OpenAI/Volcengine)
`EMBEDDING_BASE_URL`	-	Custom API endpoint
`EMBEDDING_BATCH_SIZE`	`20`	Batch processing size
`EMBEDDING_TIMEOUT`	`30`	Request timeout (seconds)

Supported Embedding Providers

sentence-transformers (local, default):

EMBEDDING_PROVIDER=sentence-transformers
EMBEDDING_MODEL=all-MiniLM-L6-v2
EMBEDDING_DIMENSION=384

OpenAI:

EMBEDDING_PROVIDER=openai
EMBEDDING_MODEL=text-embedding-3-small
EMBEDDING_DIMENSION=1536
EMBEDDING_API_KEY=sk-xxx

Volcengine:

EMBEDDING_PROVIDER=volc-engine
EMBEDDING_MODEL=doubao-embedding
EMBEDDING_DIMENSION=1024
EMBEDDING_API_KEY=your-api-key

Complete Configuration Example

# Security
SECRET_KEY=your-long-random-secret-key-at-least-32-chars
DEBUG=false

# Database
POSTGRES_PASSWORD=your-secure-database-password

# Ports
WEB_PORT=80
ADMIN_PORT=3001

# Admin (first startup)
CREATE_ADMIN=true
ADMIN_USERNAME=admin
ADMIN_PASSWORD=YourSecurePassword123!

# Logging
LOG_LEVEL=INFO

# Embedding (using OpenAI)
EMBEDDING_PROVIDER=openai
EMBEDDING_MODEL=text-embedding-3-small
EMBEDDING_DIMENSION=1536
EMBEDDING_API_KEY=sk-xxx

Applying Configuration

Restart services after modifying configuration:

# Restart all services
docker compose down
docker compose up -d

# Or restart specific services only
docker compose restart backend worker

Verifying Configuration

# Check service status
docker compose ps

# View backend logs
docker compose logs backend

# Check health status
curl http://localhost/api/health

Next Steps

HTTPS Setup - Configure SSL certificates
Backup & Restore - Data backup strategies