Panoramica

LibreChat utilizza quattro file di configurazione principali. Ognuno controlla un aspetto diverso dell'applicazione, dalle variabili d'ambiente agli endpoint AI personalizzati, fino agli override dei servizi Docker.

Flusso di lavoro comune per le modifiche

La maggior parte delle modifiche alla configurazione segue lo stesso schema:

1. Modifica .env per segreti, chiavi API e flag di funzionalità a livello di server.
2. Modifica librechat.yaml per endpoint personalizzati, Model Specs, impostazioni dell'interfaccia, server MCP, agenti e comportamento avanzato dell'app.
3. Per Docker, assicurati che librechat.yaml sia montato tramite docker-compose.override.yml prima di aspettarti che LibreChat lo legga.
4. Riavvia LibreChat dopo ogni modifica alla configurazione.
5. Controlla i log dell'API se la modifica non appare nell'interfaccia utente.

Ad esempio, per abilitare OpenRouter aggiungi OPENROUTER_KEY a .env, aggiungi un endpoint OpenRouter in librechat.yaml, assicurati che Docker monti librechat.yaml, riavvia, quindi seleziona OpenRouter dal selettore di endpoint.

File di configurazione

.env -- Impostazioni a livello di server: chiavi API, stringhe di connessione al database, feature flag e segreti di autenticazione. Questo è il file di configurazione principale per la maggior parte delle distribuzioni. Consulta il riferimento .env per tutte le variabili disponibili.

librechat.yaml -- Endpoint AI personalizzati, impostazioni dei modelli, opzioni dell'interfaccia e funzionalità avanzate come server MCP e agenti. Questo file è facoltativo: LibreChat funziona con le impostazioni predefinite se non esiste. Consulta la guida a librechat.yaml per le istruzioni di configurazione.

docker-compose.yml -- Definisce i servizi Docker (server API, database, ricerca). Non modificare direttamente questo file: utilizza invece un file di override affinché le tue modifiche sopravvivano agli aggiornamenti.

docker-compose.override.yml -- Le tue personalizzazioni locali per i servizi Docker: mount dei volumi, mappature delle porte, override delle variabili d'ambiente. Docker Compose unisce automaticamente questo file con quello principale. Consulta la guida all'override di Docker.

Applicazione delle modifiche

docker compose down && docker compose up -d

npm run backend

Prossimi passi