Docker

Untuk sebagian besar skenario, Docker Compose adalah metode instalasi yang direkomendasikan karena kesederhanaan, kemudahan penggunaan, dan keandalannya.

Prasyarat

• Git
• Docker

Docker Desktop direkomendasikan untuk sebagian besar pengguna. Untuk instalasi server jarak jauh, lihat Panduan Deployment Docker Ubuntu.

services:
  mongodb:
    image: mongo:4.4.18

Instalasi

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

cp .env.example .env

docker compose up -d

Memasang librechat.yaml

Untuk menggunakan file konfigurasi librechat.yaml kustom dengan Docker, Anda perlu memasangnya sebagai volume agar container dapat mengaksesnya.

Salin file contoh override dan edit file tersebut:

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

Pastikan volume mount librechat.yaml tidak dikomentari di dalam docker-compose.override.yml:

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

Mulai ulang agar perubahan diterapkan:

docker compose down && docker compose up -d

Untuk instruksi pengaturan lengkap termasuk membuat file dari awal, lihat panduan librechat.yaml. Untuk opsi penggantian (override) lainnya, lihat panduan Docker override.

Memperbarui LibreChat

Perintah berikut akan mengambil perubahan proyek LibreChat terbaru, termasuk perubahan apa pun yang diperlukan pada file docker compose, serta image pra-bangun terbaru.

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

Pemecahan Masalah

Port Sudah Digunakan

Jika Anda melihat kesalahan seperti bind: address already in use untuk port 3080, aplikasi lain sedang menggunakan port tersebut.

Entah hentikan aplikasi yang mengalami konflik, atau ubah port di docker-compose.override.yml:

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

Kemudian kunjungi http://localhost:3081 sebagai gantinya.

Container Mengalami Crash saat Startup

Jika container keluar segera setelah dimulai, periksa log:

docker compose logs api

Penyebab umum:

• Sintaks librechat.yaml tidak valid -- validasi dengan YAML Validator
• File .env tidak ditemukan -- pastikan .env ada di root proyek
• Docker tidak berjalan -- pastikan Docker Desktop sudah terbuka dan berjalan

Variabel Lingkungan yang Hilang

Jika fitur tidak berfungsi sebagaimana mestinya, periksa apakah variabel lingkungan yang diperlukan telah diatur di dalam file .env Anda.

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

Lihat .env reference untuk semua variabel yang tersedia dan nilai default-nya.

Langkah Selanjutnya