Variables d'environnement

Chatbotaurus utilise des variables d'environnement pour configurer le backend, le frontend et les services d'infrastructure. Ce guide liste les variables disponibles par categorie.

Configuration des modeles IA

Variable	Role	Valeurs	Defaut
OLLAMA_BASE_URL	URL du serveur Ollama	URL (ex: http://chatbotaurus-ollama:11434)	http://localhost:11434
OLLAMA_MODEL	Modele principal	qwen3:8b	qwen3:8b
OLLAMA_DRAFT_MODEL	Modele leger (chat, draft)	tomng/nanbeige4.1:3b	tomng/nanbeige4.1:3b
OLLAMA_EMBEDDING_MODEL	Modele d'embeddings	qwen3-embedding:0.6b	qwen3-embedding:0.6b
OLLAMA_TEMPERATURE	Temperature des reponses	Float entre 0.0 et 1.0	0.7

Base de donnees

Variable	Role	Valeurs	Defaut
DATABASE_HOST	Hote PostgreSQL	Hostname ou IP	chatbotaurus-postgres
DATABASE_PORT	Port PostgreSQL	Entier	5432
DATABASE_NAME	Nom de la base	String	chatbotaurus
DATABASE_USER	Utilisateur	String	chatbotaurus
DATABASE_PASSWORD	Mot de passe	String	Via Vault en production

Cache (Valkey)

Variable	Role	Valeurs	Defaut
VALKEY_HOST	Hote Valkey	Hostname ou IP	chatbotaurus-valkey
VALKEY_PORT	Port Valkey	Entier	6379
CACHE_TTL	Duree de vie du cache (secondes)	Entier	1800
CACHE_MAX_SIZE_MB	Taille max du cache in-memory	Entier	10

Recherche vectorielle (Qdrant)

Variable	Role	Valeurs	Defaut
QDRANT_URL	URL du serveur Qdrant	URL	http://chatbotaurus-qdrant:6333
QDRANT_COLLECTION	Nom de la collection	String	chatbotaurus
QDRANT_VECTOR_SIZE	Dimension des vecteurs	Entier	1024

Authentification (Keycloak)

Variable	Role	Valeurs	Defaut
KEYCLOAK_URL	URL du serveur Keycloak	URL	http://chatbotaurus-keycloak:8180
KEYCLOAK_REALM	Realm Keycloak	String	chatbotaurus
KEYCLOAK_CLIENT_ID	Client ID backend	String	chatbotaurus-backend
KEYCLOAK_CLIENT_SECRET	Client secret	String	Via Vault

Secrets (Vault)

Variable	Role	Valeurs	Defaut
VAULT_ADDR	URL du serveur Vault	URL	http://chatbotaurus-vault:8200
VAULT_TOKEN	Token d'acces Vault	String	Genere au demarrage
VAULT_MCP_PATH	Chemin des secrets MCP	String	secret/data/mcp-servers

MCP Gateway

Variable	Role	Valeurs	Defaut
MCP_SESSION_TTL	Duree de vie des sessions MCP (minutes)	Entier	30
MCP_BATCH_MAX_SIZE	Taille max des batches JSON-RPC	Entier	50
MCP_TIMEOUT_DEMO	Timeout mode demo en ms	Entier	10000
MCP_TIMEOUT_DEFAULT	Timeout production en ms	Entier	15000
MCP_TIMEOUT_HEAVY	Timeout operations lourdes en ms	Entier	30000

Serveur

Variable	Role	Valeurs	Defaut
PORT	Port du serveur backend	Entier	3000
NODE_ENV	Environnement Node.js	development, staging, production	development
LOG_LEVEL	Niveau de log	debug, info, warn, error	info
CORS_ORIGIN	Origines CORS autorisees	URL(s)	http://localhost:3001

Frontend (Next.js)

Les variables frontend doivent etre prefixees par NEXT_PUBLIC_ pour etre accessibles cote client :

Variable	Role	Valeurs	Defaut
NEXT_PUBLIC_API_URL	URL de l'API backend	URL	http://localhost:3000
NEXT_PUBLIC_KEYCLOAK_URL	URL Keycloak	URL	http://localhost:8180
NEXT_PUBLIC_KEYCLOAK_REALM	Realm Keycloak	String	chatbotaurus
NEXT_PUBLIC_KEYCLOAK_CLIENT_ID	Client ID frontend	String	chatbotaurus-ui

Deploiement (VPS)

Variable	Role	Valeurs
VPS1_HOST	IP du VPS1 (Core)	147.79.101.76
VPS2_HOST	IP du VPS2 (Demo MGaaS)	72.60.92.14
SSH_PORT	Port SSH	2222
REGISTRY_URL	Registry d'images	registry.chatbotaurus.eu

Priorite de configuration

1. Variables d'environnement systeme (priorite haute)
2. Fichier .env.staging ou .env.production
3. Fichier .env (priorite basse)

Securite

Ne stockez jamais de secrets (mots de passe, tokens, cles API) dans les fichiers .env en production. Utilisez Vault pour la gestion securisee des secrets.

Voir aussi

• Fichiers de configuration - Vue d'ensemble de la configuration
• Deploiement Podman - Configuration infrastructure