Aller au contenu principal

LibreChat sur Google Cloud Run

LibreChat sur Google Cloud Run

LibreChat est une interface de chat IA open source avec plus de 20 000 étoiles GitHub qui reproduit et étend l'expérience ChatGPT sur plus de 20 fournisseurs de LLM (OpenAI, Anthropic, Google Gemini, Mistral, Groq, Ollama, et bien d'autres). Ce module déploie LibreChat sur Cloud Run v2 sur la base de la fondation App_CloudRun, qui provisionne et gère l'infrastructure Google Cloud partagée.

Ce guide se concentre sur les services cloud utilisés par LibreChat et sur la manière de les explorer et de les opérer depuis la Google Cloud Console et la ligne de commande. Pour les mécaniques communes à chaque application Cloud Run — identité de service, ingress et équilibrage de charge, mise à l'échelle et concurrence, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC Service Controls, sauvegardes et cycle de vie du déploiement — reportez-vous au guide de la fondation App_CloudRun plutôt que de les répéter ici.


Ce que coûte LibreChat sur RAD, et comment cela se compare​

LibreChat sur le module Cloud Run de RAD coûte environ 46 $ US par mois dans un projet Google Cloud que vous possédez, plus des frais de module uniques de 75 crédits (7,50 $ US). LibreChat est gratuit et open source, sans base de données propre dans ce module — les conversations et les paramètres résident sur le serveur de fichiers partagé — vous ne payez donc que pour le calcul et les fournisseurs de LLM que vous connectez, facturés séparément. Si vous n'en avez besoin qu'occasionnellement, un projet géré par RAD peut être supprimé et restauré dans les 30 jours sans frais supplémentaires, de sorte que ces 46 $ US deviennent quelques dollars par mois. Voir Mettre en pause gratuitement, ci-dessous.

Ce que vous payez sur RAD​

Dans un projet Google Cloud que vous possédezDans un projet géré par RAD pour vous
Frais de module, une fois par déploiement75 crédits (7,50 $ US au prix de la recharge)67,5 crédits (10 % de moins)
BuildsInclus dans le prix : pas de frais de build pour la création, 5 mises à jour par mois (mois calendaire UTC) gratuites puis 2 crédits chacune, et rien pour la suppression ou pour un build échoué, dans la limite de 10 builds échoués par jour (UTC). Les sessions de lab et les projets clients sont l'exception : ils sont toujours facturés au temps de build à la minuteIdem
Coût d'exécution Google CloudFacturé par Google à votre propre compte de facturation, environ 46 $ US par mois pour la configuration par défaut (tableau ci-dessous)Mesuré à l'heure en crédits ; RAD publie 29 crédits par jour, environ 870 par mois (environ 87 $ US au prix de la recharge)
Qui possède quoiVous possédez le projet et sa facturation ; RAD le déploie et le met à jourRAD possède le projet, avec des garde-fous, des quotas et des alertes budgétaires ; vous avez accès à la console, et un solde minimum acheté est maintenu en réserve

Votre premier déploiement réussi sur RAD est exempt de frais de module, quel que soit le montant : une fois par compte, pour un module que vous déployez et payez vous-même (dans une solution, les frais d'une application : la première à réussir ; jamais une session de lab ou un projet client).

10 crédits coûtent 1 $ US pour une recharge unique, et moins pour un plan mensuel. Dans un projet géré par RAD, la base de données, le serveur de fichiers et le réseau sont partagés par chaque application du projet, de sorte qu'une deuxième application n'ajoute pas une deuxième base de données.

Coût d'exécution par défaut dans votre propre projet (us-central1, prix catalogue Google) :

Ressource (par défaut du module)Par mois
Cloud Run, 2x vCPU / 2 GiB (chaud)26,28 $ US
Serveur de fichiers NFS/cache (petite VM)13,43 $ US
Cloud NAT et réseau5,00 $ US
Cloud Storage (modules complémentaires, sauvegardes)1,00 $ US
Totalenviron 46 $ US

Comment cela se compare​

  • Il n'existe pas de SaaS LibreChat hébergé officiel — c'est une interface utilisateur alternative à ChatGPT auto-hébergée par conception, il n'y a donc pas de prix fournisseur à comparer.
  • Dimensionné à ses 2 vCPU/2 GiB plus un serveur de fichiers partagé, un Hetzner CPX22 ou un DigitalOcean 2 vCPU/4 Go Droplet (environ 24 $/mois) est moins cher en espèces — mais vous gérez alors le stockage de fichiers, les sauvegardes et les correctifs de sécurité vous-même, et les appels aux fournisseurs de LLM sont facturés séparément de toute façon.
  • Les identifiants gérés par RAD (Secret Manager) et les sauvegardes sont les plus importants lorsque plusieurs personnes partagent une instance LibreChat plutôt qu'une seule personne l'exécutant sur un ordinateur portable.
  • Voir le guide GKE pour un déploiement qui reste disponible pour toute une organisation.

Mettre en pause gratuitement : supprimer un projet géré par RAD, le restaurer quand vous en avez besoin​

Si LibreChat s'exécute dans un projet géré par RAD pour vous, vous avez une deuxième option qui va bien au-delà de la mise à l'échelle à zéro : supprimer l'ensemble du projet et le restaurer dans les 30 jours pour presque rien. Cela convient bien mieux à LibreChat dont vous n'avez besoin qu'occasionnellement — un projet de cours, une démo, une évaluation de courte durée — que de le faire fonctionner en continu.

Une restauration n'est pas garantie — conservez vos propres sauvegardes. Les conditions de Google Cloud ne garantissent pas qu'un projet restauré, ou les ressources qu'il contient, sera utilisable après sa restauration, de sorte que la restauration ne peut pas être considérée comme un moyen de récupérer un projet supprimé. Avant de supprimer, assurez-vous d'avoir effectué des sauvegardes appropriées des données et de la configuration de l'application et de les avoir stockées en dehors du projet. Si une restauration échoue, ou si le projet restauré ne fonctionne pas, la solution de repli consiste à redéployer l'application (voir la section suivante) et à restaurer sa configuration et ses données à partir de ces sauvegardes.

  • Comment ça marche. La suppression d'un projet géré par RAD délie d'abord sa facturation, puis demande à Google de supprimer le projet. Google ne supprime pas le projet immédiatement : il le conserve, récupérable, pendant 30 jours. Comme la facturation est déjà déliée, rien n'est facturé pendant cette attente. Contrairement à la suppression d'un module, cela ne détruit pas une VM ou le calcul propre de LibreChat un par un — l'ensemble du projet, et tout ce qu'il contient, s'arrête simplement.
  • La restauration est une vérification, pas une reconstruction. Dans les 30 jours, le propriétaire du projet peut le restaurer. RAD demande à Google de restaurer le projet et rattache son compte de facturation, puis vous demande d'exécuter Mettre à jour sur chaque déploiement pour confirmer que tout est revenu. Comme rien n'a été détruit individuellement, cette mise à jour trouve les mêmes ressources déjà présentes — c'est une vérification, pas une reconstruction, et une mise à jour ne facture plus jamais les frais de module. Les mises à jour sont incluses dans le prix (5 par mois pour chaque déploiement), donc une restauration ne coûte normalement aucun crédit.
  • Ce que cela nécessite. Vous devez posséder le projet (pas un projet que vous apportez et dont RAD ne gère que la facturation), et vous le restaurez vous-même dans les 30 jours — après cela, Google le supprime définitivement. La restauration est admise comme la création d'un nouveau projet : votre solde de crédits achetés doit toujours dépasser le seuil du palier (100 crédits pour le palier sandbox qui convient à la plupart des utilisations d'étude et de démonstration). Google indique que la plupart des services sont à nouveau entièrement fonctionnels dans les 36 heures suivant une restauration.
  • Un véritable manque : le bucket de sauvegarde ne survit pas. Les sauvegardes nocturnes de LibreChat sont écrites dans un bucket à l'intérieur du projet, et ce bucket n'est pas protégé par la suppression logicielle de Cloud Storage, il est donc très probable qu'il disparaisse dès que vous supprimez le projet — même si le projet lui-même est récupérable pendant 30 jours. Si vous avez personnalisé LibreChat et que vous souhaitez conserver ce travail, copiez une sauvegarde (vers Google Drive, ou un bucket en dehors du projet) avant de supprimer, comme pour le flux de travail de redéploiement ci-dessous. Pour une installation par défaut sans rien d'irremplaçable, cela n'a pas d'importance.

Payer uniquement pendant l'utilisation, l'autre méthode : supprimer et redéployer​

Ce module maintient Cloud Run chaud (au moins une instance allouée) plutôt que de se mettre à l'échelle complètement à zéro, de sorte qu'une partie de son coût est déjà continue. L'option ci-dessus ne s'applique qu'à un projet géré par RAD ; dans votre propre projet, ou une fois la fenêtre de 30 jours passée, la façon d'arrêter de payer est de supprimer le déploiement et de le redéployer lorsque vous en avez besoin.

  • Ce que coûte un redéploiement. Les frais de module à nouveau (les builds sont inclus) : 75 crédits (7,50 $ US), car RAD recrée le projet et les services partagés avant LibreChat. La suppression ne permet d'économiser de l'argent que si LibreChat reste inutilisé pendant environ six jours ou plus, à la fois dans votre propre projet (environ 1,52 $ US par jour) et dans un projet géré par RAD (29 crédits par jour).
  • Supprimer tout ce que LibreChat utilise. La majeure partie du coût d'exécution est généralement la VM de fichier/cache partagée. Elle ne s'arrête que si rien d'autre dans le projet ne l'utilise, donc la suppression de LibreChat alors que quelque chose d'autre partage le projet n'économise que la partie calcul propre de LibreChat.
  • Conservez d'abord vos données. Les sauvegardes nocturnes vont dans un bucket à l'intérieur du déploiement et sont supprimées avec lui, alors copiez la dernière sauvegarde avant de la supprimer si vous voulez la conserver.

Sessions de lab et environnements gérés​

  • Sessions de lab, pour la formation. Un formateur anime une session LibreChat pour une classe. Chaque participant dispose de LibreChat dans son propre projet Google Cloud pendant 15 minutes à 24 heures, dans la limite d'une allocation définie par le formateur. Le formateur peut aussi créer un seul environnement partagé pour toute la classe, et chacun utilise alors la même application et ses données. Soit le formateur finance toutes les places à l'avance, soit chaque participant paie la sienne. Tout est supprimé à la fin de la session, et les crédits non utilisés sont reversés au formateur.
  • Environnements gérés, pour les sociétés de conseil. Un partenaire exécute LibreChat pour un client à partir d'un portefeuille cloisonné qu'il finance, et règle directement avec le client. Si le portefeuille est faible, la facturation est suspendue et les données sont conservées, de sorte que personne ne reçoit de frais inattendus. À la fin de l'engagement, le partenaire transfère le projet, et les déploiements deviennent la propriété du client.

Les crédits peuvent être achetés dans plus de 20 devises, y compris XAF, XOF, NGN, GHS, KES et ZAR, par carte, virement bancaire ou argent mobile.

Sources (8 octobre 2026) : Prix catalogue Google Cloud de l'API Cloud Billing Catalog ; frais RAD et estimation quotidienne de 21 crédits de radmodules.dev/pricing ; Supprimer et restaurer des projets pour la fenêtre de récupération de 30 jours et ce qu'il dit sur les objets Cloud Storage sans suppression logicielle. Les prix changent ; vérifiez chaque source avant de vous fier à un chiffre.

1. Vue d'ensemble​

LibreChat s'exécute en tant que conteneur Node.js sur Cloud Run v2. Le déploiement relie un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculCloud Run v2Service Node.js, 2 vCPU / 2 GiB par défaut, autoscaling basé sur les requêtes
Base de donnéesMongoDB (sidecar mongo:7 intégré par défaut)Cloud SQL n'est pas utilisé ; la compatibilité MongoDB de Firestore est une alternative optionnelle
Stockage d'objetsCloud StorageUn bucket dédié aux téléchargements de fichiers, plus des buckets supplémentaires optionnels
SecretsSecret ManagerClés JWT, clés de chiffrement des identifiants et URI MongoDB auto-générés
Cache et sessionsRedis (optionnel)Requis pour les déploiements multi-instances afin de maintenir la cohérence des sessions
IngressURL Cloud Run / Équilibrage de charge CloudURL run.app par défaut, équilibreur de charge HTTPS externe optionnel + domaine personnalisé

Valeurs par défaut judicieuses à connaître à l'avance :

  • Pas de Cloud SQL. LibreChat utilise MongoDB. Par défaut, mongodb_uri pointe vers un sidecar mongo:7 intégré (mongodb://127.0.0.1:27017/LibreChat), ajouté en tant qu'entrée additional_containers dans le même service Cloud Run, avec son répertoire de données sur le volume NFS partagé (/data/db). L'API compatible MongoDB de Firestore s'authentifie mais ignore les commandes de démarrage de LibreChat, elle n'est donc pas la valeur par défaut — effacez mongodb_uri à "" (et définissez firestore_mongodb_host, ou laissez les deux vides pour la découverte automatique) pour opter pour Firestore à la place.
  • Le sidecar MongoDB fait du service un singleton. Parce que ses données résident sur NFS à un chemin unique, min_instance_count = max_instance_count = 1 par défaut. Pointez vers un MongoDB externe (Atlas, auto-hébergé ou Firestore) pour dépasser une instance.
  • La base de données Firestore n'est jamais supprimée lors de la destruction (lorsqu'elle est utilisée). Si vous optez pour l'auto-provisionnement de Firestore, la base de données est conservée pour éviter la perte de données ; supprimez-la manuellement si elle n'est plus nécessaire.
  • Les secrets JWT et d'identifiants sont auto-générés lors du premier déploiement et stockés dans Secret Manager. La rotation de CREDS_KEY ou CREDS_IV après que les utilisateurs ont enregistré les identifiants du fournisseur d'IA rend tous les identifiants stockés indéchiffrables.
  • La mise à l'échelle à zéro est désactivée par défaut (min_instance_count = 1). Les démarrages à froid de LibreChat peuvent prendre 15 à 30 secondes en raison de la connexion MongoDB et du chargement des actifs.
  • Redis est désactivé par défaut. Activez-le pour tout déploiement avec plus d'une instance — sans Redis, l'état de session est isolé par instance et les utilisateurs perdent leurs sessions lors des événements de mise à l'échelle.
  • Le délai d'expiration est de 600 secondes par défaut. Les réponses IA de longue durée via le streaming SSE nécessitent un délai d'expiration généreux.
  • max_instance_count est par défaut 1 dans la variante Cloud Run. Le déploiement par défaut intègre un sidecar MongoDB dont le répertoire de données réside sur un seul volume NFS partagé ; plusieurs instances écrivant dans le même répertoire de données peuvent provoquer une corruption. Lorsque vous pointez vers un MongoDB externe, augmentez cette limite librement.

2. Services Google Cloud et comment les explorer​

Toutes les commandes supposent que PROJECT et REGION sont définis. Les noms de service et de ressource sont rapportés dans les Sorties du déploiement.

A. Cloud Run — le service LibreChat​

LibreChat s'exécute en tant que service Cloud Run v2 qui s'adapte automatiquement à la charge de requêtes entre les nombres d'instances minimum et maximum. Chaque déploiement crée une révision immuable ; le trafic peut être réparti entre les révisions pour des déploiements sûrs.

  • Console : Cloud Run → sélectionnez le service pour les révisions, le trafic, les journaux et les métriques.
  • CLI :
    gcloud run services list --project "$PROJECT" --region "$REGION"
    gcloud run services describe <service-name> --project "$PROJECT" --region "$REGION"
    gcloud run revisions list --service <service-name> --project "$PROJECT" --region "$REGION"

Voir App_CloudRun pour la mise à l'échelle, la concurrence, l'environnement d'exécution et la répartition du trafic.

B. MongoDB — la base de données LibreChat​

LibreChat stocke tout l'historique des chats, les comptes utilisateurs et la configuration dans MongoDB. Par défaut, un conteneur officiel mongo:7 s'exécute en tant que sidecar intégré dans le même service Cloud Run (additional_containers), accessible par le conteneur principal à 127.0.0.1:27017, avec son répertoire de données (/data/db) sur le volume NFS partagé. Alternativement, effacez mongodb_uri à "" pour opter pour une base de données Firestore ENTERPRISE avec compatibilité MongoDB (auto-découverte ou créée), ou pointez mongodb_uri vers MongoDB Atlas ou toute instance MongoDB auto-hébergée accessible depuis le VPC.

  • Console : Cloud Run → le détail de la révision du service affiche le conteneur sidecar mongo. Firestore → sélectionnez la base de données (lorsque le mode Firestore est utilisé ; l'ID correspond à firestore_mongodb_database, par défaut LibreChat).
  • CLI :
    # Inspect the sidecar and its NFS-backed data directory:
    gcloud run services describe <service-name> --project "$PROJECT" --region "$REGION" --format=json | jq '.spec.template.spec.containers'
    # If using Firestore mode:
    gcloud firestore databases list --project "$PROJECT"
    gcloud firestore databases describe LibreChat --project "$PROJECT"

Récupérez l'URI MongoDB de Secret Manager pour vérifier la connectivité :

gcloud secrets list --project "$PROJECT" --filter="name~mongo-uri"
gcloud secrets versions access latest --secret=<mongo-uri-secret> --project "$PROJECT"

C. Cloud Storage — téléchargements de fichiers​

LibreChat_Common provisionne un bucket Cloud Storage dédié librechat-uploads pour les téléchargements de fichiers utilisateur partagés dans le chat (images, documents). Le compte de service de la charge de travail est automatiquement autorisé.

  • Console : Cloud Storage → Buckets → recherchez le bucket avec le suffixe uploads.
  • CLI :
    gcloud storage buckets list --project "$PROJECT"
    gcloud storage ls gs://<uploads-bucket>/

Voir App_CloudRun pour les montages NFS, GCS Fuse et les options CMEK.

D. Secret Manager — secrets d'application auto-générés​

LibreChat nécessite plusieurs secrets cryptographiques qui sont générés automatiquement lors du premier déploiement et ne sont jamais exposés en texte clair.

Suffixe du secretVariable d'environnementObjectif
creds-keyCREDS_KEYClé AES-GCM hexadécimale de 32 octets pour les identifiants de fournisseur enregistrés
creds-ivCREDS_IVIV AES-GCM hexadécimal de 16 octets — associé à CREDS_KEY
jwt-secretJWT_SECRETSigne les jetons d'accès utilisateur
jwt-refresh-secretJWT_REFRESH_SECRETSigne les jetons d'actualisation de longue durée
mongo-uriMONGO_URIChaîne de connexion MongoDB
  • Console : Sécurité → Secret Manager.
  • CLI :
    gcloud secrets list --project "$PROJECT"
    gcloud secrets versions access latest --secret=<secret-name> --project "$PROJECT"

Voir App_CloudRun pour les détails d'injection et de rotation.

E. Cache Redis (optionnel)​

Redis prend en charge la gestion des sessions de LibreChat et la mise en file d'attente des messages en temps réel. Il est requis lorsque plus d'une instance est en cours d'exécution — sans lui, chaque instance a un état de session en mémoire isolé et les utilisateurs perdent leurs sessions lors des événements de mise à l'échelle.

  • Console : Memorystore → Redis (si vous utilisez une instance gérée).
  • CLI :
    redis-cli -h <redis-host> ping
    redis-cli -h <redis-host> info keyspace

F. Réseau et ingress​

Le service est accessible à son URL run.app par défaut. Un équilibreur de charge HTTPS externe avec un domaine personnalisé, Cloud CDN et Cloud Armor peuvent être superposés ; les paramètres d'ingress et le contrôle d'egress VPC contrôlent la connectivité.

  • Console : Cloud Run (URL du service) ; Services réseau → Équilibrage de charge.
  • CLI :
    gcloud run services describe <service-name> --region "$REGION" --format='value(status.url)'
    gcloud compute addresses list --project "$PROJECT"

Voir App_CloudRun.

G. Cloud Logging et Monitoring​

Les journaux de conteneurs sont envoyés à Cloud Logging ; les métriques Cloud Run sont envoyées à Cloud Monitoring, avec des vérifications de disponibilité et des politiques d'alerte optionnelles.

  • Console : Logging → Explorateur de journaux ; Monitoring → Tableaux de bord / Alertes.
  • CLI :
    gcloud run services logs read <service-name> --project "$PROJECT" --region "$REGION" --limit 50

3. Comportement de l'application LibreChat​

  • Pas de job de migration de base de données. LibreChat migre automatiquement son schéma MongoDB lors du premier démarrage ; aucun job d'initialisation séparé n'est nécessaire.

  • Sidecar MongoDB intégré par défaut. mongodb_uri est par défaut mongodb://127.0.0.1:27017/LibreChat, pointant vers un conteneur officiel mongo:7 ajouté en tant qu'entrée additional_containers dans le même service Cloud Run ; son répertoire de données réside sur le volume NFS partagé, c'est pourquoi le service est par défaut un singleton min = max = 1.

  • Auto-provisionnement Firestore (optionnel). Définissez mongodb_uri = "" pour l'activer : lorsque mongodb_uri est vide et qu'aucun firestore_mongodb_host n'est défini, le module découvre ou crée une base de données Firestore ENTERPRISE avec compatibilité MongoDB. Un utilisateur SCRAM est provisionné automatiquement. La base de données n'est jamais détruite avec le module.

  • Clés API du fournisseur d'IA. LibreChat se connecte aux API du fournisseur d'IA (OpenAI, Anthropic, etc.) au moment de la requête. Injectez les clés du fournisseur via secret_environment_variables, qui fait référence à des secrets Secret Manager préexistants. Ne transmettez pas les clés en texte clair environment_variables — elles apparaîtraient dans les métadonnées de révision Cloud Run et les journaux d'audit GCP.

  • Chemin de santé. Les sondes de démarrage et de vivacité ciblent toutes deux / (la racine de LibreChat), qui renvoie HTTP 200 une fois l'application entièrement initialisée et connectée à MongoDB. La sonde de démarrage a un seuil d'échec généreux pour permettre l'établissement de la connexion MongoDB au premier démarrage.

  • Continuité SSE et WebSocket. LibreChat utilise les événements envoyés par le serveur (SSE) pour le streaming des réponses IA. Assurez-vous que timeout_seconds est défini suffisamment haut (600 s par défaut) pour éviter de tronquer les longues réponses IA en cours de flux.

  • Enregistrement des utilisateurs. L'auto-enregistrement est activé par défaut. Définissez allow_registration = false après avoir créé le compte administrateur initial pour empêcher les inscriptions non autorisées sur les déploiements publics.

  • Variables d'environnement automatiquement injectées. Les éléments suivants sont toujours définis par le module et n'ont pas besoin d'être fournis manuellement :

    VariableValeurObjectif
    HOST0.0.0.0Liaison sur toutes les interfaces à l'intérieur du conteneur
    NODE_ENVproductionOptimisations de production
    TRUST_PROXY1Express lit X-Forwarded-For correctement derrière l'ingress Cloud Run
    APP_TITLEvar.app_titleTitre de l'en-tête de l'interface utilisateur
    DOMAIN_CLIENT / DOMAIN_SERVERURL du serviceURI de redirection OAuth et liens e-mail
    ALLOW_REGISTRATIONvar.allow_registrationIndicateur d'auto-enregistrement

4. Variables de configuration​

Les variables sont regroupées exactement comme elles apparaissent sur la plateforme de déploiement. Seuls les paramètres spécifiques ou notables pour LibreChat sont listés ; toutes les autres entrées sont héritées de App_CloudRun avec son comportement standard.

Groupe 1 — Projet et identité​

VariableValeur par défautDescription
project_id(requis)Projet Google Cloud cible.
regionus-central1Région pour le service et les ressources régionales.
firestore_mongodb_host""Hôte du point de terminaison MongoDB de Firestore (remplacement manuel). Laissez vide pour la découverte automatique.

Groupe 2 — Environnement de déploiement​

VariableValeur par défautDescription
tenant_iddemoSuffixe court qui rend les noms de ressources uniques par environnement.
support_users[]Adresses e-mail autorisées à accéder au projet et aux alertes de surveillance.
resource_labels{}Étiquettes appliquées à toutes les ressources.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_namelibrechatNom de base des ressources. Ne pas modifier après le premier déploiement.
application_display_nameLibreChat AI ChatNom convivial affiché dans la Console.
application_description(défini)Description du service.
application_versionlatestVersion de l'image LibreChat — épingler à une version spécifique en production.
mongodb_urimongodb://127.0.0.1:27017/LibreChatURI de connexion MongoDB (sensible). Par défaut, le sidecar mongo:7 intégré. Définir à "" pour utiliser l'auto-provisionnement Firestore, ou fournir un URI MongoDB/Atlas externe.
app_titleLibreChatTitre affiché dans l'en-tête de l'interface utilisateur LibreChat et l'onglet du navigateur.
allow_registrationtrueAutoriser les nouveaux utilisateurs à s'auto-enregistrer. Définir false après la création du compte administrateur initial.
allow_social_loginfalseActiver les fournisseurs de connexion sociale OAuth. Nécessite une configuration d'application OAuth dans librechat.yaml.
allow_social_registrationnullAutoriser la création de compte via la connexion sociale. Par défaut, la valeur de allow_social_login.

Groupe 4 — Exécution et mise à l'échelle​

VariableValeur par défautDescription
deploy_applicationtrueDéfinir false pour provisionner uniquement l'infrastructure.
container_image_sourceprebuiltprebuilt (GHCR) ou custom (Cloud Build).
container_imageghcr.io/danny-avila/librechatURI de l'image du conteneur.
container_resources{ cpu_limit = "2000m", memory_limit = "2Gi" }CPU et mémoire par instance ; minimum 2 vCPU / 2 GiB.
container_port3080Port HTTP natif de LibreChat.
execution_environmentgen2Gen2 requis pour les montages NFS et GCS Fuse.
timeout_seconds600Durée maximale de la requête ; augmenter pour les backends LLM lents ou les longues réponses IA.
min_instance_count1Instances minimales. Garder ≥ 1 pour éviter les démarrages à froid et les flux SSE interrompus.
max_instance_count1Instances maximales. Garder à 1 lors de l'utilisation du sidecar MongoDB intégré.
enable_cloudsql_volumefalseDoit rester false. LibreChat n'utilise pas Cloud SQL.
enable_image_mirroringtrueMettre en miroir l'image GHCR vers Artifact Registry — évite les limites de débit.
traffic_split[]Allocation de trafic Canary / bleu-vert entre les révisions.

Groupe 5 — Accès et contrôle d'ingress​

VariableValeur par défautDescription
ingress_settingsallall — internet public ; internal — VPC uniquement ; internal-and-cloud-load-balancing — via HTTPS LB.
vpc_egress_settingPRIVATE_RANGES_ONLYComment le trafic sortant est acheminé via le connecteur VPC.
enable_iapfalseExiger la connexion Google via Identity-Aware Proxy.
iap_authorized_users / iap_authorized_groups[]Qui peut accéder via IAP.

Groupe 6 — Variables d'environnement et secrets​

VariableValeur par défautDescription
environment_variables{}Paramètres supplémentaires non secrets. Les variables principales de LibreChat sont définies automatiquement.
secret_environment_variables{}Mappage de variable d'environnement → nom de secret Secret Manager. Utiliser ceci pour les clés API du fournisseur d'IA.
secret_propagation_delay30Secondes à attendre après la création du secret avant de continuer.
secret_rotation_period2592000sFréquence de notification de rotation de Secret Manager.

Groupe 7 — Sauvegarde et restauration​

VariableValeur par défautDescription
backup_schedule0 2 * * *Cron de sauvegarde NFS automatisée (UTC).
backup_retention_days7Rétention ; augmenter pour la production/conformité.

Groupe 8 — CI/CD et Binary Authorization​

Intégration standard App_CloudRun Cloud Build / Cloud Deploy — voir App_CloudRun. Entrées clés : enable_cicd_trigger, github_repository_url, github_token, enable_cloud_deploy, enable_binary_authorization.

Groupe 9 — Instance NFS​

VariableValeur par défautDescription
nfs_instance_name / nfs_instance_base_name(défini)Instance NFS existante / nom de base pour une instance intégrée.

Groupe 10 — Domaine, CDN, Cloud Armor et rétention d'images​

VariableValeur par défautDescription
enable_cloud_armorfalseProvisionner Global HTTPS LB + Cloud Armor WAF.
admin_ip_ranges[]CIDR exemptés des règles WAF.
application_domains[]Noms d'hôtes personnalisés pour l'équilibreur de charge externe.
enable_cdnfalseActiver Cloud CDN sur le backend LB. Nécessite enable_cloud_armor = true.
max_images_to_retain / delete_untagged_images / image_retention_days(défini)Politique de nettoyage d'Artifact Registry.

Groupe 11 — Stockage et système de fichiers​

VariableValeur par défautDescription
create_cloud_storagetrueProvisionner des buckets GCS supplémentaires.
storage_buckets[{ name_suffix = "data" }]Buckets supplémentaires au-delà du bucket de téléchargements auto-provisionné.
enable_nfstrueVolume Filestore partagé ; requis par le sidecar MongoDB intégré (stocke /data/db). Désactiver uniquement lors de l'utilisation d'un MongoDB externe.
nfs_mount_path/mnt/nfsChemin de montage à l'intérieur du conteneur.
gcs_volumes[]Buckets GCS à monter via GCS Fuse.
manage_storage_kms_iam / enable_artifact_registry_cmekfalseOptions CMEK.

Groupe 12 — Base de données / MongoDB​

VariableValeur par défautDescription
database_typeNONEFixe — ne pas modifier. LibreChat n'utilise pas Cloud SQL.
firestore_mongodb_databaseLibreChatID de base de données Firestore / nom de base de données MongoDB.
firestore_mongodb_username""Nom d'utilisateur SCRAM pour l'authentification Firestore.
firestore_mongodb_password""Mot de passe SCRAM (sensible). Auto-généré s'il n'est pas défini.

Groupe 13 — Jobs et tâches planifiées​

VariableValeur par défautDescription
initialization_jobs[]Laisser vide — LibreChat migre automatiquement MongoDB au démarrage. Ajouter des tâches de configuration personnalisées si nécessaire.
cron_jobs[]Jobs récurrents déclenchés par Cloud Scheduler (nettoyage des données, préchauffage du cache, etc.).

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probe / startup_probe_config{ path="/", initial_delay_seconds=30, failure_threshold=10 }Sonde HTTP permettant le temps de connexion MongoDB et de chargement des actifs.
liveness_probe / health_check_config{ path="/", initial_delay_seconds=60, failure_threshold=3 }Sonde de vivacité ciblant le chemin racine de LibreChat.
uptime_check_config{ enabled=false, path="/" }Vérification de disponibilité Cloud Monitoring ; désactivée par défaut.
alert_policies[]Politiques d'alerte métrique.

Groupe 21 — Redis​

VariableValeur par défautDescription
enable_redisfalseActiver Redis pour la gestion des sessions. Requis pour les déploiements multi-instances.
redis_host""Point de terminaison Redis. Requis lorsque enable_redis = true.
redis_port6379Port Redis.
redis_auth""Mot de passe d'authentification Redis optionnel (sensible).

Groupe 22 — VPC Service Controls et Audit Logging​

VariableValeur par défautDescription
enable_vpc_scfalseAppliquer un périmètre VPC-SC (nécessite organization_id).
vpc_cidr_ranges / vpc_sc_dry_run(défini)CIDR de niveau d'accès / mode simulation.
enable_audit_loggingfalseJournaux d'audit Cloud détaillés.

5. Sorties​

Retourné lors d'un déploiement réussi — le moyen le plus rapide de localiser et d'explorer les ressources en cours d'exécution.

SortieDescription
service_nameNom du service Cloud Run.
service_urlURL run.app par défaut du service.
service_locationRégion dans laquelle le service s'exécute.
stage_servicesURL de service spécifiques à l'étape (Cloud Deploy).
load_balancer_ip / load_balancer_urlIP / URL de l'équilibreur de charge HTTPS externe (lorsqu'il est activé).
storage_bucketsBuckets Cloud Storage créés (inclut le bucket de téléchargements).
network_name / network_exists / regionsRéseau VPC, présence, régions.
container_image / container_registryImage déployée et dépôt Artifact Registry.
monitoring_enabled / monitoring_notification_channels / uptime_check_namesÉtat de la surveillance, canaux, vérifications de disponibilité.
initialization_jobsNoms des jobs de configuration exécutés.
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.
cicd_enabled / github_repository_url / github_repository_owner / github_repository_name / cicd_configurationÉtat et détails CI/CD.
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_idRegistre et déclencheur de build.
vpc_sc_enabled / vpc_sc_perimeter_name / vpc_sc_dry_run_modeÉtat VPC-SC.
audit_logging_enabled / artifact_registry_cmek_enabledJournalisation d'audit et état CMEK.

6. Pièges de configuration et valeurs par défaut judicieuses​

Risque : Critique (perte de données / panne / sécurité) — Élevé (service dégradé) — Moyen (coût ou dégradation partielle) — Faible (mineur).

ParamètreValeur judicieuseRisqueConséquence en cas d'erreur
CREDS_KEY / CREDS_IV (auto-généré)défini une foisCritiqueClés AES-GCM pour les identifiants de fournisseur d'IA enregistrés. La rotation après que les utilisateurs ont enregistré des clés détruit tous les identifiants stockés — chaque utilisateur doit ressaisir ses clés API.
mongodb_urilaisser par défaut (sidecar) ou définir explicitementCritiqueLibreChat nécessite MongoDB. Le sidecar mongo:7 intégré par défaut nécessite que NFS soit activé pour son répertoire de données ; effacer mongodb_uri à "" avec une configuration Firestore/Atlas défectueuse fait planter le conteneur au démarrage et ne sert aucun trafic.
enable_cloudsql_volumefalseCritiqueDoit rester false. L'activation injecte un sidecar Cloud SQL Auth Proxy inutile.
database_typeNONECritiqueLa définition d'un moteur SQL provisionne une instance Cloud SQL inutilisée à un coût supplémentaire.
secret_environment_variables (clés AI)utiliser des secretsCritiqueLes clés de fournisseur d'IA passées en environment_variables sont visibles dans les métadonnées de révision Cloud Run et les journaux d'audit GCP. Toujours utiliser les références Secret Manager.
allow_registrationfalse après la configurationÉlevéL'enregistrement ouvert sur un déploiement public permet à quiconque de créer un compte. Désactiver après la création de l'administrateur ou restreindre avec IAP.
enable_redistrue pour multi-instanceÉlevéSans Redis, chaque instance a un état de session en mémoire isolé ; les utilisateurs perdent leurs sessions lors d'événements de mise à l'échelle.
redis_hostpoint de terminaison expliciteÉlevéRequis lorsque enable_redis = true. Si vide, LibreChat ne peut pas se connecter à Redis.
max_instance_count1 avec MongoDB intégréÉlevéPlusieurs instances écrivant dans le même répertoire de données MongoDB sauvegardé par NFS peuvent corrompre la base de données. N'augmenter que lors de l'utilisation d'un MongoDB externe.
enable_nfstrue avec MongoDB intégréÉlevéLe sidecar MongoDB intégré stocke son répertoire de données (/data/db) sur NFS. La désactivation de NFS supprime le stockage durable et les données MongoDB sont perdues au redémarrage.
timeout_seconds600ÉlevéLe streaming SSE pour les longues réponses AI peut dépasser plusieurs minutes. Un délai d'attente insuffisant tronque les réponses en cours de diffusion.
min_instance_count1ÉlevéLa mise à l'échelle à zéro interrompt tous les flux SSE en cours et provoque une latence de démarrage à froid au réveil.
JWT_SECRET (auto-généré)défini une foisÉlevéLa rotation invalide toutes les sessions actives simultanément. Planifier la rotation pendant une fenêtre de maintenance.
application_versionversion épingléeMoyenlatest peut introduire des modifications de schéma MongoDB ou des incompatibilités d'API lors de mises à niveau non planifiées.
enable_iap / enable_cloud_armoractiver pour la productionMoyenLibreChat est autrement directement accessible depuis l'internet public avec seulement une connexion au niveau de l'application pour le protéger.
execution_environmentgen2ÉlevéLes montages NFS ne sont pas pris en charge dans la génération 1. Toujours utiliser la génération 2 pour les déploiements compatibles NFS.

Pour le comportement de base référencé tout au long — identité de service, mise à l'échelle et concurrence, entrée et équilibrage de charge, CI/CD, Cloud Armor, IAP, autorisation binaire, VPC-SC, sauvegardes, et mise en miroir d'images — voir App_CloudRun. La configuration d'application spécifique à LibreChat partagée avec la variante GKE est décrite dans LibreChat_Common.

Need RAD to do something it does not do yet? Request it on the roadmap, or vote on what is already there.