Docker

W większości scenariuszy Docker Compose jest zalecaną metodą instalacji ze względu na swoją prostotę, łatwość użycia i niezawodność.

Wymagania wstępne

• Git
• Docker

Docker Desktop jest zalecany dla większości użytkowników. W przypadku instalacji na zdalnym serwerze, zobacz Przewodnik wdrażania Docker na Ubuntu.

services:
  mongodb:
    image: mongo:4.4.18

Instalacja

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

cp .env.example .env

docker compose up -d

Montowanie librechat.yaml

Aby użyć niestandardowego pliku konfiguracyjnego librechat.yaml z Docker, musisz zamontować go jako wolumin, aby kontener miał do niego dostęp.

Skopiuj przykładowy plik nadpisujący (override) i edytuj go:

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

Upewnij się, że montowanie wolumenu librechat.yaml jest odkomentowane w docker-compose.override.yml:

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

Zrestartuj, aby zmiany weszły w życie:

docker compose down && docker compose up -d

Pełne instrukcje konfiguracji, w tym tworzenie pliku od zera, znajdują się w przewodniku po librechat.yaml. Więcej opcji nadpisywania można znaleźć w przewodniku po nadpisywaniu Docker.

Aktualizacja LibreChat

Poniższe polecenia pobiorą najnowsze zmiany w projekcie LibreChat, w tym wszelkie niezbędne zmiany w plikach docker compose, a także najnowsze gotowe obrazy.

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

Rozwiązywanie problemów

Port jest już używany

Jeśli widzisz błąd typu bind: address already in use dla portu 3080, oznacza to, że inna aplikacja korzysta z tego portu.

Albo zatrzymaj konfliktową aplikację, albo zmień port w docker-compose.override.yml:

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

Następnie odwiedź http://localhost:3081.

Awaria kontenera podczas uruchamiania

Jeśli kontenery wyłączają się natychmiast po uruchomieniu, sprawdź logi:

docker compose logs api

Typowe przyczyny:

• Nieprawidłowa składnia librechat.yaml -- sprawdź poprawność za pomocą YAML Validator
• Brak pliku .env -- upewnij się, że .env znajduje się w katalogu głównym projektu
• Docker nie jest uruchomiony -- upewnij się, że Docker Desktop jest otwarty i działa

Brakujące zmienne środowiskowe

Jeśli funkcje nie działają zgodnie z oczekiwaniami, sprawdź, czy wymagane zmienne środowiskowe są ustawione w pliku .env.

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

Zobacz .env reference, aby uzyskać listę wszystkich dostępnych zmiennych oraz ich wartości domyślnych.

Następne kroki