Docker

Çoğu senaryo için, basitliği, kullanım kolaylığı ve güvenilirliği nedeniyle Docker Compose önerilen kurulum yöntemidir.

Ön Koşullar

• Git
• Docker

Çoğu kullanıcı için Docker Desktop önerilir. Uzak sunucu kurulumları için Ubuntu Docker Deployment Guide bölümüne bakın.

services:
  mongodb:
    image: mongo:4.4.18

Kurulum

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

cp .env.example .env

docker compose up -d

librechat.yaml dosyasını bağlama

Docker ile özel bir librechat.yaml yapılandırma dosyası kullanmak için, dosyayı konteynerin erişebilmesi adına bir birim (volume) olarak bağlamanız gerekir.

Örnek geçersiz kılma (override) dosyasını kopyalayın ve düzenleyin:

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

docker-compose.override.yml dosyasında librechat.yaml birim bağlamasının (volume mount) açıklama satırı olmaktan çıkarıldığından emin olun:

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

Değişikliklerin geçerli olması için yeniden başlatın:

docker compose down && docker compose up -d

Sıfırdan dosya oluşturma dahil tam kurulum talimatları için librechat.yaml kılavuzuna bakın. Daha fazla geçersiz kılma (override) seçeneği için Docker geçersiz kılma kılavuzuna bakın.

LibreChat'i Güncelleme

Aşağıdaki komutlar, docker compose dosyalarındaki gerekli değişiklikler de dahil olmak üzere en son LibreChat proje değişikliklerini ve en son önceden oluşturulmuş (prebuilt) imajları getirecektir.

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

Sorun Giderme

Bağlantı Noktası (Port) Zaten Kullanımda

3080 numaralı bağlantı noktası için bind: address already in use gibi bir hata görürseniz, başka bir uygulama bu bağlantı noktasını kullanıyordur.

Ya çakışan uygulamayı durdurun ya da docker-compose.override.yml dosyasındaki portu değiştirin:

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

Ardından http://localhost:3081 adresini ziyaret edin.

Konteyner Başlangıçta Çöküyor

Kapsayıcılar başladıktan hemen sonra kapanıyorsa, günlükleri kontrol edin:

docker compose logs api

Yaygın nedenler:

• Geçersiz librechat.yaml sözdizimi -- YAML Validator ile doğrulayın
• .env dosyası eksik -- .env dosyasının proje kök dizininde bulunduğundan emin olun
• Docker çalışmıyor -- Docker Desktop'ın açık ve çalışır durumda olduğundan emin olun

Eksik Ortam Değişkenleri

Özellikler beklendiği gibi çalışmıyorsa, gerekli ortam değişkenlerinin .env dosyanızda ayarlanmış olduğunu kontrol edin.

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

Tüm mevcut değişkenler ve varsayılan değerleri için .env referansına bakın.

Sonraki Adımlar