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.

Variables pour OpenCode, Git et le terminal

Pour donner vos propres variables à OpenCode, à Git, au terminal et aux actions de projet, comme un jeton d’API ou l’adresse d’une base de données, ajoutez-les dans Paramètres → Général → Variables d’environnement plutôt que de les exporter avant de lancer OpenChamber. Les valeurs restent sur la machine qui fait tourner OpenChamber, dans environment.json dans le dossier de données, et seul votre utilisateur peut les lire. Les Paramètres n’affichent plus jamais une valeur : vous pouvez la remplacer ou la supprimer, pas la relire.

OpenCode les reçoit au démarrage, donc redémarrez-le après un changement. Les Paramètres proposent le bouton.
Les variables définies avec opencode service set env arrivent aussi jusqu’à OpenCode. Celles des Paramètres l’emportent.
Git, le terminal et les actions de projet les reçoivent à leur prochaine exécution.
Les variables qu’OpenChamber définit pour OpenCode lui-même, comme son mot de passe et sa configuration, l’emportent sur les vôtres.

Un projet peut ajouter ses propres variables, ou une commande qui les affiche comme direnv export json, dans Paramètres → Projets. Voir Projets.

Ces variables n’atteignent pas un serveur OpenCode que vous avez lancé vous-même, et l’extension VS Code n’a pas ce réglage. Tout ce qui suit est lu par OpenChamber lui-même au démarrage.

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_LAN_URL`

L’adresse à laquelle les autres appareils de votre réseau joignent OpenChamber, par exemple http://192.168.1.20:3000. Les liens et QR codes d’appairage la proposent à la place de l’adresse détectée par OpenChamber. Définissez-la quand cette détection se trompe, par exemple dans Docker, où OpenChamber ne voit que l’adresse interne du conteneur.

`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_UI_SESSION_TTL_HOURS`

Durée d’une connexion dans le navigateur, en heures, quand « faire confiance à cet appareil » est désactivé. La valeur par défaut est 12.

`OPENCHAMBER_UI_TRUSTED_SESSION_TTL_DAYS`

Durée d’une connexion, en jours, sur un appareil auquel vous faites confiance. La valeur par défaut est 7.

`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_FRAME_ANCESTORS`

Origines autorisées à afficher OpenChamber dans un cadre sur leur propre page, séparées par des espaces, par exemple https://dash.example.com. * autorise n’importe quel site. Par défaut, seuls OpenChamber et ses apps desktop et mobile peuvent l’intégrer, ce qui empêche d’autres sites de superposer ses boutons.

`OPENCHAMBER_DATA_DIR`

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

`OPENCHAMBER_CHATS_DIR`

Déplace les dossiers de chat gérés qu’OpenChamber crée pour les chats sans projet. La valeur par défaut est ~/.config/openchamber/chats. Indiquez un dossier lisible par le serveur OpenCode lorsque OpenChamber et OpenCode tournent sous des utilisateurs différents. Les chats existants ne sont pas déplacés.

`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 quand elles appellent OpenAI lui-même. Elle n’est jamais envoyée à un serveur compatible OpenAI personnalisé : donnez à ce serveur sa propre clé dans les Réglages.

`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.