Overzicht

LibreChat gebruikt vier hoofdconfiguratiebestanden. Elk bestand beheert een ander aspect van de applicatie -- van omgevingsvariabelen tot aangepaste AI-endpoints en Docker-service-overrides.

Algemene wijzigingsworkflow

De meeste configuratiewijzigingen volgen hetzelfde patroon:

1. Bewerk .env voor secrets, API-sleutels en feature flags op serverniveau.
2. Bewerk librechat.yaml voor aangepaste endpoints, Model Specs, interface-instellingen, MCP servers, agents en geavanceerd app-gedrag.
3. Voor Docker moet je ervoor zorgen dat librechat.yaml is gemount via docker-compose.override.yml voordat je verwacht dat LibreChat het inleest.
4. Herstart LibreChat na elke configuratiewijziging.
5. Controleer de API-logs als de wijziging niet in de UI verschijnt.

Om bijvoorbeeld OpenRouter in te schakelen, voeg je OPENROUTER_KEY toe aan .env, voeg je een OpenRouter endpoint toe in librechat.yaml, zorg je ervoor dat Docker librechat.yaml mount, start je opnieuw op en selecteer je vervolgens OpenRouter in de endpoint-kiezer.

Configuratiebestanden

.env -- Instellingen op serverniveau: API-sleutels, database-verbindingsreeksen, feature flags en authenticatiegeheimen. Dit is het primaire configuratiebestand voor de meeste implementaties. Zie de .env reference voor alle beschikbare variabelen.

librechat.yaml -- Aangepaste AI-endpoints, modelinstellingen, interface-opties en geavanceerde functies zoals MCP-servers en agents. Dit bestand is optioneel -- LibreChat werkt met standaardinstellingen als het niet bestaat. Zie de librechat.yaml guide voor installatie-instructies.

docker-compose.yml -- Definieert de Docker-services (API-server, database, search). Bewerk dit bestand niet rechtstreeks -- gebruik in plaats daarvan een override-bestand zodat je wijzigingen behouden blijven na updates.

docker-compose.override.yml -- Jouw lokale aanpassingen aan Docker-services: volume mounts, poorttoewijzingen, omgevings-overrides. Docker Compose voegt dit automatisch samen met het hoofdbestand. Zie de Docker override guide.

Wijzigingen toepassen

docker compose down && docker compose up -d

npm run backend

Volgende stappen