Übersicht

LibreChat verwendet vier Hauptkonfigurationsdateien. Jede steuert einen anderen Aspekt der Anwendung – von Umgebungsvariablen über benutzerdefinierte AI-endpoints bis hin zu Docker-Service-Overrides.

Allgemeiner Änderungsworkflow

Die meisten Konfigurationsänderungen folgen demselben Muster:

1. Bearbeiten Sie .env für Geheimnisse, API-Schlüssel und Feature-Flags auf Serverebene.
2. Bearbeiten Sie librechat.yaml für benutzerdefinierte endpoints, Model Specs, Schnittstelleneinstellungen, MCP-Server, Agents und fortgeschrittenes App-Verhalten.
3. Stellen Sie bei Docker sicher, dass librechat.yaml über docker-compose.override.yml eingebunden ist, bevor Sie erwarten, dass LibreChat sie liest.
4. Starten Sie LibreChat nach jeder Konfigurationsänderung neu.
5. Überprüfen Sie die API-Logs, falls die Änderung nicht in der UI erscheint.

Um beispielsweise OpenRouter zu aktivieren, fügen Sie OPENROUTER_KEY zur .env hinzu, fügen Sie einen OpenRouter endpoint in der librechat.yaml hinzu, stellen Sie sicher, dass Docker die librechat.yaml einbindet, starten Sie neu und wählen Sie dann OpenRouter aus dem endpoint-Auswahlmenü aus.

Konfigurationsdateien

.env -- Einstellungen auf Serverebene: API-Schlüssel, Datenbank-Verbindungszeichenfolgen, Feature-Flags und Authentifizierungsgeheimnisse. Dies ist die primäre Konfigurationsdatei für die meisten Bereitstellungen. Siehe die .env reference für alle verfügbaren Variablen.

librechat.yaml – Benutzerdefinierte KI-endpoints, Modelleinstellungen, Interface-Optionen und erweiterte Funktionen wie MCP-Server und Agents. Diese Datei ist optional – LibreChat funktioniert mit Standardwerten, falls sie nicht existiert. Siehe den librechat.yaml guide für Einrichtungsanweisungen.

docker-compose.yml -- Definiert die Docker-Dienste (API-Server, Datenbank, Suche). Bearbeiten Sie diese Datei nicht direkt – verwenden Sie stattdessen eine Override-Datei, damit Ihre Änderungen bei Updates erhalten bleiben.

docker-compose.override.yml -- Ihre lokalen Anpassungen für Docker-Dienste: Volume-Mounts, Port-Mappings, Umgebungsvariablen-Überschreibungen. Docker Compose führt diese automatisch mit der Hauptdatei zusammen. Siehe den Docker override guide.

Änderungen anwenden

docker compose down && docker compose up -d

Nächste Schritte