Core Environment Configuration
The system is configured through standard POSIX environment variables defined in the .env file at the repository root. Docker Compose forwards these parameters to the respective service containers.
1. Database Connections
| Variable | Default Value | Description |
|---|
POSTGRES_DB | lifescience_qms_rag | PostgreSQL canonical database name |
POSTGRES_USER | gxp_admin | Database administrative username |
POSTGRES_PASSWORD | gxp_secure_password_2026 | Database administrative password |
POSTGRES_HOST_PORT | 5434 | External host port mapped to PostgreSQL 5432 |
QDRANT_HOST_PORT | 6335 | External host port mapped to Qdrant HTTP 6333 |
QDRANT_GRPC_HOST_PORT | 6336 | External host port mapped to Qdrant gRPC 6334 |
QDRANT_COLLECTION | lifescience_qms_docs | Target vector collection name |
MEMGRAPH_HOST_PORT | 7688 | External host port mapped to Memgraph Bolt 7687 |
MEMGRAPH_LAB_HOST_PORT | 3006 | External host port mapped to Memgraph Lab web UI |
2. Large Language Model & Embedding Parameters
| Variable | Default Value | Description |
|---|
LLM_MODEL | deepseek-v4-flash | Foundation model identifier for Pydantic AI agents |
DEEPSEEK_API_KEY | (empty) | API authorization token for DeepSeek platform |
DEEPSEEK_BASE_URL | https://api.deepseek.com | Base endpoint URL for DeepSeek API |
OPENAI_API_KEY | (empty) | Optional OpenAI API token for GPT-4o models |
OLLAMA_BASE_URL | http://host.docker.internal:11434 | Endpoint for host-managed Ollama instances |
EMBEDDING_PROVIDER | ollama | Provider for vector embedding generation (ollama or openai) |
EMBEDDING_MODEL | qwen3-embedding:8b | Model identifier for dense embeddings |
EMBEDDING_DIMENSION | 4096 | Dimensional vector width (must match Qdrant schema) |
3. S3-Compatible Object Storage (RustFS)
| Variable | Default Value | Description |
|---|
RUSTFS_HOST_API_PORT | 9120 | External host port mapped to RustFS S3 API 9000 |
RUSTFS_HOST_CONSOLE_PORT | 9121 | External host port mapped to RustFS Web UI 9001 |
RUSTFS_ACCESS_KEY | gxp_rustfs_admin | Administrative S3 access key ID |
RUSTFS_SECRET_KEY | gxp_rustfs_secure_secret_2026 | Administrative S3 secret access key |
RUSTFS_BUCKET_DOCS | gxp-instrument-manuals | Monitored S3 bucket for incoming instrument manuals |
RUSTFS_BUCKET_ETL | gxp-migration-staging | Monitored S3 bucket for legacy migration archives |
4. Langfuse Observability Stack
| Variable | Default Value | Description |
|---|
LANGFUSE_HOST_PORT | 3001 | External host port for Langfuse Web Console |
LANGFUSE_PUBLIC_KEY | pk-lf-cc0daf7c-4b94-45a6-86b7-0a1c3ece0704 | Public project API key for client-side tracing |
LANGFUSE_SECRET_KEY | sk-lf-f82a68c8-50bb-4d79-bbab-1aaef839fa95 | Secret API key for backend span dispatch |
LANGFUSE_HOST | http://langfuse:3000 | Internal container network endpoint for Langfuse |
LANGFUSE_ENABLED | true | Boolean flag enabling or disabling telemetry dispatch |
5. Consolidated Web Suite (GxPChat) & Documentation Wiki
| Variable | Default Value | Description |
|---|
CHATBOT_HOST_PORT | 3002 (or 3010) | Host port for GxPChat unified Next.js application |
WIKI_HOST_PORT | 4321 | Host port for Astro Starlight documentation wiki |
INTERNAL_API_BASE_URL | http://api:8000 | Internal network route for GxPChat reverse proxy |
MCP_SERVERS | [{"name":"gxp-agent","type":"sse","url":"http://api:8000/mcp/sse"}] | FastMCP server discovery configuration |
DOCX_HOST_PORT | 5055 | Host port for ASP.NET Core DOCX export service |