Docker

Para la mayoría de los escenarios, Docker Compose es el método de instalación recomendado debido a su simplicidad, facilidad de uso y confiabilidad.

Requisitos previos

• Git
• Docker

Docker Desktop es recomendado para la mayoría de los usuarios. Para instalaciones en servidores remotos, consulte la Guía de despliegue de Docker en Ubuntu.

services:
  mongodb:
    image: mongo:4.4.18

Instalación

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

cp .env.example .env

docker compose up -d

Montaje de librechat.yaml

Para usar un archivo de configuración librechat.yaml personalizado con Docker, necesitas montarlo como un volumen para que el contenedor pueda acceder a él.

Copia el archivo de ejemplo de anulación y edítalo:

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

Asegúrate de que el montaje de volumen de librechat.yaml esté descomentado en docker-compose.override.yml:

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

Reinicie para que los cambios surtan efecto:

docker compose down && docker compose up -d

Para obtener instrucciones de configuración completas, incluyendo la creación del archivo desde cero, consulta la guía de librechat.yaml. Para más opciones de anulación, consulta la guía de anulación de Docker.

Actualizando LibreChat

Los siguientes comandos obtendrán los cambios más recientes del proyecto LibreChat, incluyendo cualquier modificación necesaria en los archivos docker compose, así como las imágenes precompiladas más recientes.

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

Solución de problemas

Puerto ya en uso

Si ves un error como bind: address already in use para el puerto 3080, otra aplicación está utilizando ese puerto.

O detenga la aplicación en conflicto, o cambie el puerto en docker-compose.override.yml:

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

Entonces visita http://localhost:3081 en su lugar.

El contenedor se cierra al iniciar

Si los contenedores se cierran inmediatamente después de iniciarse, revisa los registros:

docker compose logs api

Causas comunes:

• Sintaxis de librechat.yaml no válida: valídela con el YAML Validator
• Falta el archivo .env: asegúrese de que .env exista en la raíz del proyecto
• Docker no se está ejecutando -- asegúrate de que Docker Desktop esté abierto y en ejecución

Variables de entorno faltantes

Si las funciones no funcionan como se espera, verifique que las variables de entorno requeridas estén configuradas en su archivo .env.

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

Consulta la .env reference para ver todas las variables disponibles y sus valores predeterminados.

Próximos pasos