概要

LibreChatは4つの主要な設定ファイルを使用します。それぞれが、環境変数からカスタムAI endpoint、Dockerサービスのオーバーライドに至るまで、アプリケーションの異なる側面を制御します。

一般的な変更ワークフロー

ほとんどの設定変更は、同じパターンに従います：

1. .env を編集して、シークレット、APIキー、およびサーバーレベルの機能フラグを設定します。
2. librechat.yaml を編集して、カスタム endpoint、Model Specs、インターフェース設定、MCP サーバー、エージェント、および高度なアプリの動作を設定します。
3. Dockerの場合、LibreChatがlibrechat.yamlを読み込めるようにするためには、事前にdocker-compose.override.ymlを通じてマウントされていることを確認してください。
4. 設定を変更するたびにLibreChatを再起動してください。
5. 変更がUIに反映されない場合は、APIログを確認してください。

例えば、OpenRouterを有効にするには、.envにOPENROUTER_KEYを追加し、librechat.yamlにOpenRouterのendpointを追加し、Dockerがlibrechat.yamlをマウントしていることを確認して再起動した後、endpointセレクターからOpenRouterを選択します。

設定ファイル

.env -- サーバーレベルの設定：APIキー、データベース接続文字列、機能フラグ、認証シークレット。これはほとんどのデプロイメントにおける主要な設定ファイルです。利用可能なすべての変数については、.env reference を参照してください。

librechat.yaml -- カスタムAI endpoint、モデル設定、インターフェースオプション、およびMCPサーバーやエージェントなどの高度な機能。このファイルはオプションです。存在しない場合、LibreChatはデフォルト設定で動作します。設定手順については、librechat.yamlガイドを参照してください。

docker-compose.yml -- Dockerサービス（APIサーバー、データベース、検索）を定義します。このファイルを直接編集しないでください。更新時に変更が上書きされないよう、代わりにオーバーライドファイルを使用してください。

docker-compose.override.yml -- Docker サービスに対するローカルなカスタマイズ（ボリュームマウント、ポートマッピング、環境変数のオーバーライドなど）を記述します。Docker Compose はこれをメインファイルと自動的にマージします。詳細は Docker override guide を参照してください。

変更の適用

docker compose down && docker compose up -d

次のステップ