Aller au contenu

Variables d’environnement

OpenChamber lit ces variables d’environnement au démarrage. Pour les services de démarrage, openchamber startup enable capture l’environnement actuel par défaut ; relancez donc la commande après avoir changé les variables que le service doit utiliser.

Serveur OpenChamber

OPENCHAMBER_HOST

Adresse d’écoute du serveur web OpenChamber. Utilisez 0.0.0.0 pour autoriser l’accès depuis d’autres machines.

OPENCHAMBER_UI_PASSWORD

Mot de passe pour l’UI navigateur. Utilisez-le lorsque vous écoutez hors de localhost, utilisez des tunnels ou passez derrière un reverse proxy.

OPENCHAMBER_API_ONLY

Démarre OpenChamber en mode headless lorsqu’il vaut true ou 1. Les routes API restent disponibles pour les clients desktop et mobile, mais l’UI navigateur n’est pas servie.

OPENCHAMBER_DATA_DIR

Remplace le dossier de données OpenChamber. La valeur par défaut est ~/.config/openchamber.

OPENCHAMBER_COMPRESS_API

Contrôle la compression des réponses API. Utilisez true ou 1 pour la forcer, false ou 0 pour la désactiver.

OPENCHAMBER_SKIP_API_COMPRESSION

Désactive la compression des réponses API lorsqu’il vaut true ou 1. Cette variable a priorité sur OPENCHAMBER_COMPRESS_API.

OPENCHAMBER_VERBOSE_REQUEST_LOGS

Active les logs HTTP détaillés lorsqu’il vaut true ou 1.

OPENCHAMBER_UPDATE_API_URL

Remplace l’endpoint API de vérification des mises à jour. La plupart des utilisateurs doivent laisser cette variable non définie.

OPENCHAMBER_PACKAGE_MANAGER

Force le gestionnaire de paquets utilisé par les opérations de mise à jour lorsque l’auto-détection se trompe.

Serveur OpenCode

OPENCODE_HOST

Connecte OpenChamber à un serveur OpenCode existant. La valeur doit être une origine http ou https avec un port explicite, sans chemin, query ni hash. OPENCODE_HOST a priorité sur OPENCODE_PORT.

OPENCODE_PORT

Définit le port du serveur OpenCode. Avec OpenCode géré, cela demande le port géré ; avec OPENCODE_SKIP_START=true, OpenChamber se connecte à un serveur externe sur ce port.

OPENCODE_SKIP_START

Empêche OpenChamber de démarrer son propre serveur OpenCode lorsqu’il vaut true.

OPENCHAMBER_OPENCODE_HOSTNAME

Nom d’hôte d’écoute du serveur OpenCode géré par OpenChamber. La valeur par défaut est 127.0.0.1.

OPENCODE_BINARY

Chemin vers l’exécutable opencode qu’OpenChamber doit lancer.

OPENCODE_CONFIG

Chemin vers un fichier de configuration OpenCode précis.

OPENCODE_CONFIG_DIR

Chemin vers un dossier de configuration OpenCode précis pour la découverte des agents, skills, snippets et configurations.

OPENCODE_DATA_DIR

Dossier de données personnalisé pour le serveur OpenCode géré.

OPENCODE_WSL_DISTRO

Sélectionne la distribution WSL utilisée pour l’intégration OpenCode sur Windows.

OPENCHAMBER_OPENCODE_WSL_DISTRO

Alias propre à OpenChamber pour sélectionner la distribution WSL. OPENCODE_WSL_DISTRO a priorité lorsque les deux sont définies.

OPENCODE_JWT_SECRET

Secret utilisé pour signer les tokens d’authentification UI. Utilisez une longue valeur aléatoire pour les déploiements de service persistants.

Terminal et Git

OPENCHAMBER_TERMINAL_SHELL

Exécutable shell utilisé pour les sessions de terminal OpenChamber.

OPENCHAMBER_GIT_BINARY

Exécutable Git utilisé par les fonctionnalités Git d’OpenChamber.

GIT_BINARY

Autre exécutable Git de remplacement. Préférez OPENCHAMBER_GIT_BINARY pour une configuration propre à OpenChamber.

OPENCHAMBER_GIT_READ_CACHE_TTL_MS

Durée de vie, en millisecondes, du cache de lecture des fichiers adossés à Git. Définissez 0 pour désactiver ce cache pendant le débogage.

Voix et tunnels

OPENAI_API_KEY

Clé API utilisée par les fonctionnalités vocales d’OpenChamber qui appellent des services compatibles OpenAI.

OPENCHAMBER_ALLOW_REMOTE_OPENAI_COMPAT_URLS

Autorise les URL de base compatibles OpenAI distantes pour les fonctionnalités vocales lorsqu’elle vaut true ou 1.

NGROK_AUTHTOKEN

Token d’authentification ngrok utilisé par les commandes de tunnel OpenChamber. Vous pouvez aussi configurer ngrok avec ngrok config add-authtoken <token>.

Helpers runtime

BUN_BINARY

Exécutable Bun qu’OpenChamber doit utiliser lorsqu’il lance des processus daemon.

BUN_INSTALL

Racine d’installation de Bun. OpenChamber l’utilise pour trouver bin/bun lors du démarrage des daemons et des mises à jour.

VITE_OPENCODE_URL

URL de base API à la compilation pour l’application web construite par Vite. La plupart des utilisateurs ne doivent pas la définir pour un usage CLI ou desktop normal.