Docker

Nella maggior parte degli scenari, Docker Compose è il metodo di installazione consigliato grazie alla sua semplicità, facilità d'uso e affidabilità.

Prerequisiti

• Git
• Docker

Docker Desktop è consigliato per la maggior parte degli utenti. Per le installazioni su server remoto, consulta la Guida all'installazione di Docker su Ubuntu.

services:
  mongodb:
    image: mongo:4.4.18

Installazione

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

cp .env.example .env

docker compose up -d

Montaggio di librechat.yaml

Per utilizzare un file di configurazione librechat.yaml personalizzato con Docker, è necessario montarlo come volume in modo che il container possa accedervi.

Copia il file di override di esempio e modificalo:

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

Assicurati che il mount del volume librechat.yaml sia decommentato in docker-compose.override.yml:

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

Riavvia per rendere effettive le modifiche:

docker compose down && docker compose up -d

Per le istruzioni di configurazione complete, inclusa la creazione del file da zero, consulta la guida a librechat.yaml. Per ulteriori opzioni di override, consulta la guida all'override di Docker.

Aggiornamento di LibreChat

I seguenti comandi recupereranno le ultime modifiche al progetto LibreChat, incluse eventuali modifiche necessarie ai file docker compose, così come le ultime immagini predefinite.

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

Risoluzione dei problemi

Porta già in uso

Se visualizzi un errore come bind: address already in use per la porta 3080, significa che un'altra applicazione sta utilizzando quella porta.

O interrompi l'applicazione in conflitto, o cambia la porta in docker-compose.override.yml:

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

Quindi visita http://localhost:3081 invece.

Il container si arresta all'avvio

Se i container si chiudono immediatamente dopo l'avvio, controlla i log:

docker compose logs api

Cause comuni:

• Sintassi di librechat.yaml non valida -- convalida con il YAML Validator
• File .env mancante -- assicurati che .env esista nella root del progetto
• Docker non è in esecuzione -- assicurati che Docker Desktop sia aperto e in esecuzione

Variabili d'ambiente mancanti

Se le funzionalità non funzionano come previsto, verifica che le variabili d'ambiente richieste siano impostate nel tuo file .env.

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

Consulta il .env reference per tutte le variabili disponibili e i relativi valori predefiniti.

Prossimi passi