Docker

Für die meisten Szenarien ist Docker Compose aufgrund seiner Einfachheit, Benutzerfreundlichkeit und Zuverlässigkeit die empfohlene Installationsmethode.

Voraussetzungen

• Git
• Docker

Docker Desktop wird für die meisten Benutzer empfohlen. Für Installationen auf Remote-Servern siehe den Ubuntu Docker Deployment Guide.

services:
  mongodb:
    image: mongo:4.4.18

Installation

git clone https://github.com/danny-avila/LibreChat.git
cd LibreChat

cp .env.example .env

docker compose up -d

Einbinden von librechat.yaml

Um eine benutzerdefinierte librechat.yaml Konfigurationsdatei mit Docker zu verwenden, müssen Sie diese als Volume einbinden, damit der Container darauf zugreifen kann.

Kopieren Sie die Beispiel-Override-Datei und bearbeiten Sie diese:

cp docker-compose.override.yml.example docker-compose.override.yml

Stellen Sie sicher, dass die librechat.yaml Volume-Einbindung in docker-compose.override.yml auskommentiert ist:

services:
  api:
    volumes:
      - type: bind
        source: ./librechat.yaml
        target: /app/librechat.yaml

Starten Sie neu, damit die Änderungen wirksam werden:

docker compose down && docker compose up -d

Für vollständige Einrichtungsanweisungen, einschließlich der Erstellung der Datei von Grund auf, siehe den librechat.yaml guide. Weitere Überschreibungsoptionen finden Sie im Docker override guide.

Aktualisieren von LibreChat

Die folgenden Befehle rufen die neuesten Änderungen am LibreChat-Projekt ab, einschließlich aller notwendigen Änderungen an den docker compose-Dateien sowie der neuesten vorab erstellten Images.

docker compose down

# Linux/Mac
docker images -a | grep "librechat" | awk '{print $3}' | xargs docker rmi
 
# Windows (PowerShell)
docker images -a --filter "reference=registry.librechat.ai/danny-avila/librechat*" --format "{{.ID}}" | ForEach-Object { docker rmi $_ }
docker images -a --filter "reference=ghcr.io/danny-avila/librechat*" --format "{{.ID}}" | ForEach-Object { docker rmi $_ }

git pull

docker compose pull

docker compose up

Fehlerbehebung

Port wird bereits verwendet

Wenn Sie einen Fehler wie bind: address already in use für Port 3080 sehen, verwendet eine andere Anwendung diesen Port.

Stoppen Sie entweder die in Konflikt stehende Anwendung oder ändern Sie den Port in der docker-compose.override.yml:

services:
  api:
    ports:
      - "3081:3080"

Besuchen Sie dann stattdessen http://localhost:3081.

Container stürzt beim Start ab

Wenn Container unmittelbar nach dem Start beendet werden, überprüfen Sie die Logs:

docker compose logs api

Häufige Ursachen:

• Ungültige librechat.yaml-Syntax -- bitte mit dem YAML Validator validieren
• Fehlende .env-Datei -- stellen Sie sicher, dass .env im Projektstammverzeichnis vorhanden ist
• Docker läuft nicht – stelle sicher, dass Docker Desktop geöffnet ist und läuft

Fehlende Umgebungsvariablen

Wenn Funktionen nicht wie erwartet funktionieren, überprüfen Sie, ob die erforderlichen Umgebungsvariablen in Ihrer .env Datei gesetzt sind.

docker compose exec api env | grep -i "your_variable"

Siehe die .env reference für alle verfügbaren Variablen und deren Standardwerte.

Nächste Schritte