Gambaran Umum

LibreChat menggunakan empat file konfigurasi utama. Masing-masing mengontrol aspek aplikasi yang berbeda -- mulai dari variabel lingkungan hingga endpoint AI kustom hingga penggantian layanan Docker.

Alur Kerja Perubahan Umum

Sebagian besar perubahan konfigurasi mengikuti pola yang sama:

Edit .env untuk rahasia, kunci API, dan flag fitur tingkat server.
Edit librechat.yaml untuk endpoint kustom, Model Specs, pengaturan antarmuka, server MCP, agen, dan perilaku aplikasi tingkat lanjut.
Untuk Docker, pastikan librechat.yaml telah di-mount melalui docker-compose.override.yml sebelum mengharapkan LibreChat untuk membacanya.
Mulai ulang LibreChat setelah setiap perubahan konfigurasi.
Periksa log API jika perubahan tidak muncul di UI.

Sebagai contoh, untuk mengaktifkan OpenRouter, Anda perlu menambahkan OPENROUTER_KEY ke dalam .env, menambahkan endpoint OpenRouter di librechat.yaml, memastikan Docker me-mount librechat.yaml, melakukan restart, lalu memilih OpenRouter dari pemilih endpoint.

File Konfigurasi

.env

librechat.yaml

docker-compose.yml

docker-compose.override.yml

.env -- Pengaturan tingkat server: kunci API, string koneksi basis data, flag fitur, dan rahasia autentikasi. Ini adalah file konfigurasi utama untuk sebagian besar penyebaran. Lihat referensi .env untuk semua variabel yang tersedia.

librechat.yaml -- Endpoint AI kustom, pengaturan model, opsi antarmuka, dan fitur lanjutan seperti server MCP dan agen. File ini bersifat opsional -- LibreChat akan bekerja dengan pengaturan default jika file ini tidak ada. Lihat panduan librechat.yaml untuk instruksi pengaturan.

docker-compose.yml -- Mendefinisikan layanan Docker (server API, basis data, pencarian). Jangan mengedit file ini secara langsung -- gunakan file override agar perubahan Anda tetap ada setelah pembaruan.

docker-compose.override.yml -- Kustomisasi lokal Anda untuk layanan Docker: volume mounts, pemetaan port, dan override variabel lingkungan. Docker Compose menggabungkan file ini dengan file utama secara otomatis. Lihat panduan override Docker.

Menerapkan Perubahan

Perlu Memulai Ulang

Setelah mengubah file konfigurasi apa pun, Anda harus memulai ulang LibreChat agar perubahan tersebut diterapkan.

docker compose down && docker compose up -d

Hentikan proses yang sedang berjalan (Ctrl+C) dan mulai ulang:

npm run backend

Langkah Selanjutnya

Pengaturan librechat.yaml

Buat dan konfigurasikan file konfigurasi utama LibreChat

→

Pengaturan Docker

Instal dan jalankan LibreChat dengan Docker

→

Referensi .env

Variabel lingkungan untuk konfigurasi server

→