Docker

Voor de meeste scenario's is Docker Compose de aanbevolen installatiemethode vanwege de eenvoud, het gebruiksgemak en de betrouwbaarheid.

Vereisten

• Git
• Docker

Docker Desktop wordt aanbevolen voor de meeste gebruikers. Voor installaties op externe servers, zie de Ubuntu Docker Deployment Guide.

services:
  mongodb:
    image: mongo:4.4.18

Installatie

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

cp .env.example .env

docker compose up -d

Mounting librechat.yaml

Om een aangepast librechat.yaml configuratiebestand te gebruiken met Docker, moet je het als een volume mounten zodat de container er toegang toe heeft.

Kopieer het voorbeeld-override-bestand en bewerk het:

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

Zorg ervoor dat de librechat.yaml volume mount niet is uitgeschakeld (uncommented) in docker-compose.override.yml:

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

Start opnieuw op om de wijzigingen door te voeren:

docker compose down && docker compose up -d

Voor volledige installatie-instructies, inclusief het vanaf nul aanmaken van het bestand, zie de librechat.yaml guide. Voor meer override-opties, zie de Docker override guide.

LibreChat bijwerken

De volgende commando's halen de laatste LibreChat projectwijzigingen op, inclusief alle noodzakelijke wijzigingen aan de docker compose bestanden, evenals de nieuwste vooraf gebouwde 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

Probleemoplossing

Poort al in gebruik

Als je een foutmelding ziet zoals bind: address already in use voor poort 3080, dan gebruikt een andere applicatie die poort.

Stop de conflicterende applicatie, of wijzig de poort in docker-compose.override.yml:

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

Bezoek daarna http://localhost:3081.

Container crasht bij het opstarten

Als containers onmiddellijk na het opstarten afsluiten, controleer dan de logs:

docker compose logs api

Veelvoorkomende oorzaken:

• Ongeldige librechat.yaml syntaxis -- valideer met de YAML Validator
• Ontbrekend .env bestand -- zorg ervoor dat .env in de hoofdmap van het project aanwezig is
• Docker draait niet -- zorg ervoor dat Docker Desktop geopend is en draait

Ontbrekende omgevingsvariabelen

Als functies niet werken zoals verwacht, controleer dan of de vereiste omgevingsvariabelen zijn ingesteld in je .env bestand.

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

Zie de .env reference voor alle beschikbare variabelen en hun standaardwaarden.

Volgende stappen