Genel Bakış

LibreChat yapılandırma dosyalarının birlikte nasıl çalıştığı ve değişikliklerin nasıl uygulanacağı

LibreChat dört ana yapılandırma dosyası kullanır. Her biri, ortam değişkenlerinden özel AI endpoint'lerine ve Docker hizmet geçersiz kılmalarına kadar uygulamanın farklı bir yönünü kontrol eder.

Yaygın Değişiklik İş Akışı

Çoğu yapılandırma değişikliği aynı kalıbı izler:

Gizli anahtarlar, API anahtarları ve sunucu düzeyi özellik bayrakları için .env dosyasını düzenleyin.
Özel endpoint'ler, Model Specs, arayüz ayarları, MCP sunucuları, ajanlar ve gelişmiş uygulama davranışı için librechat.yaml dosyasını düzenleyin.
Docker için, LibreChat'in librechat.yaml dosyasını okumasını beklemeden önce bu dosyanın docker-compose.override.yml aracılığıyla bağlandığından emin olun.
Her yapılandırma değişikliğinden sonra LibreChat'i yeniden başlatın.
Değişiklik arayüzde görünmüyorsa API günlüklerini kontrol edin.

Örneğin, OpenRouter'ı etkinleştirmek için .env dosyasına OPENROUTER_KEY eklemeniz, librechat.yaml dosyasına bir OpenRouter endpoint'i eklemeniz, Docker'ın librechat.yaml dosyasını bağladığından emin olmanız, yeniden başlatmanız ve ardından endpoint seçicisinden OpenRouter'ı seçmeniz gerekir.

Yapılandırma Dosyaları

.env

librechat.yaml

docker-compose.yml

docker-compose.override.yml

.env -- Sunucu düzeyi ayarlar: API anahtarları, veritabanı bağlantı dizeleri, özellik bayrakları ve kimlik doğrulama sırları. Bu, çoğu dağıtım için birincil yapılandırma dosyasıdır. Mevcut tüm değişkenler için .env referansına bakın.

librechat.yaml -- Özel AI endpoint'leri, model ayarları, arayüz seçenekleri ve MCP sunucuları ile ajanlar gibi gelişmiş özellikler. Bu dosya isteğe bağlıdır; LibreChat, dosya mevcut değilse varsayılan ayarlarla çalışır. Kurulum talimatları için librechat.yaml kılavuzuna bakın.

docker-compose.yml -- Docker servislerini (API sunucusu, veritabanı, arama) tanımlar. Bu dosyayı doğrudan düzenlemeyin; değişikliklerinizin güncellemelerden sonra da korunması için bunun yerine bir geçersiz kılma (override) dosyası kullanın.

docker-compose.override.yml -- Docker servislerine yönelik yerel özelleştirmeleriniz: birim bağlamaları (volume mounts), port eşlemeleri, ortam geçersiz kılmaları. Docker Compose bunu ana dosyayla otomatik olarak birleştirir. Docker override guide bölümüne bakın.

Değişiklikleri Uygulama

Yeniden Başlatma Gerekli

Herhangi bir yapılandırma dosyasını düzenledikten sonra, değişikliklerin geçerli olması için LibreChat'i yeniden başlatmanız gerekir.

docker compose down && docker compose up -d

Çalışan işlemi durdurun (Ctrl+C) ve yeniden başlatın:

npm run backend

Sonraki Adımlar

librechat.yaml Kurulumu

Ana LibreChat yapılandırma dosyasını oluşturun ve yapılandırın

→

Docker Kurulumu

Docker ile LibreChat'i kurun ve çalıştırın

→

.env Başvurusu

Sunucu yapılandırması için ortam değişkenleri

→