環境変数

.env ファイルを使用してアプリケーションの環境を設定するための包括的なガイドへようこそ。このドキュメントは、さまざまなコンテキストでアプリケーションの動作を決定する環境変数を理解し、カスタマイズするためのワンストップリソースです。

デフォルトの設定でも標準的な docker インストールには十分な基盤が提供されていますが、このガイドを読み進めることで LibreChat の可能性を最大限に引き出すことができます。このガイドでは、LibreChat をお客様のニーズに合わせてカスタマイズする方法を解説します。言語モデルの利用設定の調整、ソーシャルログインの統合、自動モデレーションシステムの管理など、さまざまな機能をご覧ください。LibreChat を微調整して最適なユーザーエクスペリエンスを実現するためのコントロールを、すべてお客様の手元に提供します。

注意: 設定変更を反映させるには、LibreChatを再起動してください

あるいは、LibreChatのメインの docker-compose.yml ファイルと同じディレクトリに docker-compose.override.yml という名前の新しいファイルを作成することもできます。このファイルでは、environment の下で必要に応じて .env 変数を設定したり、メインの docker-compose.yml で提供されているデフォルト設定を変更したりすることができ、ファイル全体を直接編集したり複製したりする必要はありません。

詳細については、以下を参照してください：

• クイックガイド：

  • Docker Override

• 公式のDockerドキュメント:

  • docker docs - understanding-multiple-compose-files
  • docker docs - merge-compose-files
  • docker docs - specifying-multiple-compose-files

• LibreChat フォルダー内および GitHub 上で、LibreChat のオーバーライドファイルの例を確認することもできます：

  • docker-compose.override.example

---

サーバー設定

ポート

• サーバーは特定のポートでリッスンします。
• PORT 環境変数は、サーバーがリッスンするポートを設定します。デフォルトでは 3080 に設定されています。

Trust proxy

Expressアプリケーションから最大でnホップ離れたアドレスを使用します。 req.socket.remoteAddress が最初のホップとなり、残りは X-Forwarded-For ヘッダーを右から左へ順に検索します。 値が 0 の場合、最初の信頼できないアドレスが req.socket.remoteAddress であることを意味します。つまり、リバースプロキシが存在しない状態です。 TRUST_PROXY 環境変数のデフォルト値は 1 に設定されています。

これに関する詳細については、Express.js - trust proxy を参照してください。

認証情報の構成

資格情報を安全に保存するには、固定のキーとIVが必要です。これらは、prodおよびdev環境向けにここで設定できます。

静的ファイルの処理

動作:

静的ファイルに対する Cache-Control ヘッダーを設定します。これらの設定は、NODE_ENV が production に設定されている場合にのみ有効になります。

• STATIC_CACHE_MAX_AGE のコメントアウトを解除すると、静的ファイルのローカル max-age を変更できます。デフォルトでは2日（172800秒）に設定されています。
• STATIC_CACHE_S_MAX_AGE のコメントアウトを解除して、共有キャッシュ（CDNやプロキシ）の s-maxage を設定します。デフォルトでは1日（86400秒）に設定されています。
• DISABLE_COMPRESSION のコメントアウトを解除すると、静的ファイルの圧縮が無効になります。デフォルトでは、圧縮は有効になっています。
• Uncomment ENABLE_IMAGE_OUTPUT_GZIP_SCAN to enable scanning and serving of gzipped version of images if they have been pre-compressed in the same folder, with the same name and a .gz extension. By default, gzip scan for uploaded images is disabled.
• ENABLE_STATIC_ASSET_BROTLI のコメントアウトを解除すると、静的アプリ資産の事前圧縮された .br バージョンが存在する場合にそれが提供されます。有効にすると、API経由で提供される静的ファイルに対して、gzipよりもBrotliが優先されます。

Index HTML キャッシュ制御

動作:

index.html レスポンスのキャッシュヘッダーを制御します。デフォルトでは、ユーザーが常に最新バージョンのアプリケーションを取得できるように、これらの設定はキャッシュを無効化します。

MongoDB データベース

これが異なる場合は、ご自身のMongoDB URIに変更してください。URI内のデータベース名として LibreChat または独自の APP_TITLE を追加する必要があります。

オンラインデータベースを使用している場合、URIの形式は mongodb+srv://<username>:<password>@<host>/<database>?<options> です。MONGO_URI は以下のようになります：

• mongodb+srv://username:[email protected]/LibreChat?retryWrites=true (retryWrites はオンラインデータベースを使用する際に必要な唯一のオプションです。)

MongoDB接続プールの設定

MongoDB スキーマ設定

あるいは、mongoDbをエミュレートするdocumentDbを使用することもできますが、それには以下の点があります：

• retryWrites はサポートされていません - retryWrites=false を使用してください
• TLS接続が必要です。そのため、tls=true パラメータを使用してTLSを有効にし、tlsCAFile=/path-to-ca/bundle.pem を使用してAWSが提供するCAバンドルファイルを指定してください。

documentDb の URI は以下のようになります：

• mongodb+srv://username:password@domain/dbname?retryWrites=false&tls=true&tlsCAFile=/path-to-ca/bundle.pem

参照:

• MongoDB Atlas（Dockerを使用せずに利用する場合に便利な、オンラインのMongoDB Atlasデータベースを作成する手順についてはこちら）
• MongoDB Community Server（Dockerを使用せずにローカルのMongoDBデータベースを作成する方法についてはこちらを参照）
• MongoDB Authentication DockerでMongoDBの明示的な認証を有効にするため。
• Mongo Expressでデータベースを管理する（Docker上のMongoDBデータベースに安全にアクセスするため）

アプリケーションドメイン

LibreChatをローカル環境またはカスタムドメインでデプロイするように設定するには、以下の環境変数を設定してください：

LibreChatをカスタムドメインにデプロイする際は、http://localhost:3080 をデプロイ先のURLに置き換えてください。

• 例: https://librechat.example.com

公開検索エンジンによるインデックス作成の防止

デフォルトでは、あなたのウェブサイトは公開検索エンジン（Google、Bingなど）によってインデックスされません。つまり、これらの検索エンジンを通じてあなたのウェブサイトを見つけることはできません。ウェブサイトの可視性を高め、検索可能にしたい場合は、以下の設定を false に変更してください。

❗注: この方法はすべての検索エンジンで機能することが保証されているわけではなく、一部の検索エンジンはキャッシュやアーカイブなど、他の目的でウェブサイトやウェブページをインデックスする可能性があります。したがって、ウェブサイトやウェブページ上の機密情報や極秘情報を保護するために、この方法だけに頼るべきではありません。

ログ出力

LibreChatには組み込みの中央ロギング機能があります。詳細については、Logging System を参照してください。

ログファイル

• デバッグログはデフォルトで有効になっており、開発において非常に重要です。
• 問題を報告するには、エラーを再現した上で ./api/logs/debug-%DATE%.log からログを取得し、LibreChat GitHub Issues に提出してください。
• エラーログも同じ場所に保存されます。

環境変数

注:

• DEBUG_LOGGING は DEBUG_CONSOLE または CONSOLE_JSON のいずれかと併用できますが、両方を同時に使用することはできません。
• DEBUG_CONSOLE と CONSOLE_JSON は相互排他的です。
• CONSOLE_JSON: クラウド環境（GCPやAWSなど）でコンソールログを扱う際、これを有効にするとログがUTCタイムスタンプ付きのJSON形式で出力されます。
  • 参照: feat: Add CONSOLE_JSON

注: DEBUG_CONSOLE は出力が非常に冗長になる可能性があるため、推奨されません。そのため、デフォルトでは無効になっています。

権限

UIDとGIDは、システム上の各ユーザーとグループに割り当てられるLinuxの番号です。権限の問題が発生した場合は、Docker Composeコマンドを実行しているユーザーのUIDとGIDをここに設定してください。コンテナ内のアプリケーションは、これらのUID/GIDで実行されます。

OpenTelemetry Tracing

LibreChatは、一般的なAPI、HTTP、MongoDB、Mongoose、Redis、およびアウトバウンドリクエストの可視化のために、バックエンドのOpenTelemetryトレースを出力できます。Redisコマンドレベルのスパンはオプトイン形式であるため、デフォルトのトレースは高レベルに保たれます。GenAI固有のプロンプトやモデルの可観測性については、Langfuseを使用してください。

リアルユーザーモニタリング (ブラウザ)

LibreChatは、ブラウザのReal User Monitoring (RUM) テレメトリをHyperDX互換のOTLPコレクターに公開できます。RUMはデフォルトで無効になっています。

publicToken モードでは、ブラウザは RUM_PUBLIC_TOKEN を使用して RUM_URL に直接テレメトリを送信します。proxy モードでは、ブラウザは LibreChat を介してテレメトリを送信します。バックエンドはユーザーセッションを検証し、アプリの認証ヘッダーを除去した上で、テレメトリを RUM_PROXY_TARGET_URL に転送します。無効または期限切れのセッションは 204 レスポンスで破棄されるため、ブラウザのテレメトリ失敗が通常の API 認証エラーとして表面化することはありません。プロキシの結果は、LibreChat API の /metrics エンドポイントにおいて、endpoint および result ラベルが付いた rum_proxy_requests_total としてカウントされます。

設定パス - librechat.yaml

LibreChat設定ファイルの代替場所を指定します。

絶対パス、相対パス、またはURLを指定できます。パス内のファイル名は柔軟であり、librechat.yamlである必要はありません。有効な設定ファイルであればどれでも機能します。

Note: LibreChat がルートディレクトリで設定ファイルを検索するようにしたい場合（デフォルトの動作です）、このオプションはコメントアウトしたままにしてください。

デプロイのスキル

Deployment Skillsは、起動時にファイルシステムから読み取り専用で読み込まれ、Skills機能が有効になっているユーザーに対して公開されます。

このディレクトリまたはその中のファイルを変更した後は、LibreChatを再起動してください。デプロイメントで提供されたSkillsは、同じ名前の永続化されたSkillsよりも優先されます。

設定の検証

デフォルトでは、librechat.yaml 設定ファイルに検証エラーが含まれている場合、LibreChat はエラー（終了コード 1）で終了します。このフェイルファスト（fail-fast）動作は、デプロイパイプラインの初期段階で設定の問題を検出し、意図しないデフォルト設定で実行されることを防ぐのに役立ちます。

未キャッチ例外の処理

デフォルトでは、LibreChatは捕捉されない例外が発生するとプロセスを終了しますが、これはNode.jsの標準的な動作です。この動作を上書きして、捕捉されない例外が発生した後もアプリを継続して実行するように設定できます。

Endpoints

このセクションでは、エンドポイントとモデルの選択、それらのAPIキー、およびそれをサポートするエンドポイントのプロキシとリバースプロキシ設定を構成できます。

一般設定

ENDPOINTS のコメントアウトを解除して、LibreChat で利用可能な endpoint をカスタマイズします。

既知の endpoint - librechat.yaml

• 参照: Custom Endpoints & Configuration

Web Search

Web検索機能により、LibreChat内でインターネット検索が可能になります。

重要: 以下に示されている環境変数名はデフォルトの参照値であり、librechat.yaml 設定ファイルを通じて、任意の変数名を使用するようにカスタマイズ可能です。

詳細な設定およびカスタマイズオプションについては、以下を参照してください：Web Search Configuration

注意: これらの変数名は librechat.yaml 設定ファイルでカスタマイズ可能です。例えば、ウェブ検索設定で設定することにより、SERPER_API_KEY の代わりに CUSTOM_SERPER_KEY を使用することができます。変数名のカスタマイズに関する詳細は、Web Search Configuration のドキュメントを参照してください。

Anthropic

参照: Anthropic Endpoint

• https://platform.claude.com/ からアクセスキーをリクエストできます。
• ANTHROPIC_API_KEY= を空のままにすると、この endpoint は無効になります。
• ANTHROPIC_API_KEY= を "user_provided" に設定すると、ユーザーがWebUIから自身のAPIキーを入力できるようになります。
• Anthropic のリバースプロキシにアクセスできる場合は、ANTHROPIC_REVERSE_PROXY= で設定できます。
  • デフォルトのベースURLを使用する場合は、空白のままにするか、コメントアウトしてください。

• ANTHROPIC_TITLE_MODEL は現在非推奨となっており、将来のバージョンで削除される予定です。代わりに librechat.yaml 設定内の titleModel エンドポイント設定 を使用してください。

注: Anthropic endpoint と互換性がある必要があります。また、Claude 2 および Claude 3 モデルがこのタスクに最適であり、claude-3-haiku モデルが最も安価です。

Claude Fable 5は、デフォルトのAnthropicモデルリストに含まれています。Fable/Mythosクラスのモデルは、LibreChatにおける最新のAnthropicの動作（1Mのコンテキスト、適応型推論のサポート、プロンプトキャッシングのサポート、および要約または省略された推論出力に対するthinkingDisplayの処理）を使用します。

Vertex AI 経由の Anthropic

Google Cloud Vertex AI経由でAnthropic Claudeモデルを使用することもできます。YAML設定オプションの詳細については、以下を参照してください：Anthropic Vertex AI Configuration

注: Vertex AI を使用する場合は、Vertex AI User ロールを持つサービスアカウントを使用して GOOGLE_SERVICE_KEY_FILE ( Google Configuration を参照) も設定する必要があります。

AWS Bedrock

参照: AWS Bedrock Setup

注: アクセスキーを省略すると、デフォルトの AWS 認証情報チェーン（環境変数、SSO 認証情報、共有認証情報ファイル、または EC2/ECS インスタンスメタデータサービス）が使用されます。詳細は AWS Bedrock Setup を参照してください。

Bedrock上のClaude Fable/Mythosクラスのモデルは、推論プロファイル専用です。us.anthropic.claude-fable-5 のようなプロファイルIDを使用し、呼び出す前にBedrockコンソールまたはData Retention APIで必要なAnthropicデータ共有設定を有効にしてください。

BingAI

Bing（Sydney、ジェイルブレイク、Bing Image Creatorにも使用）

注: "user_provided" のままにして、WebUIからトークンを入力することを推奨します。

Google

Google Endpoint をセットアップするには、以下の手順に従ってください。

利用可能なモデルをカンマ区切りで指定します（スペースは含めないでください）。最初に指定したモデルがデフォルトになります。空欄にするかコメントアウトすると、内部設定が使用されます。

• GOOGLE_TITLE_MODEL は現在非推奨となっており、将来のバージョンで削除される予定です。代わりに librechat.yaml 設定内の titleModel Endpoint Setting を使用してください。

注: Vertex AI の GOOGLE_SAFETY 変数については、デフォルトでは BLOCK_NONE 設定にアクセスできません。この制限された HarmBlockThreshold 設定を使用するには、以下のいずれかを行う必要があります:

• (a) Googleアカウントチームを通じて許可リスト（allowlist）によるアクセス権を取得する
• (b) 以下の手順に従って、アカウントタイプを月次請求書払い（monthly invoiced billing）に切り替えてください： https://cloud.google.com/billing/docs/how-to/invoiced-billing

Gemini 画像生成

Gemini Image Generationは、Gemini APIとVertex AIの両方をサポートするAgents向けのツールです。詳細は以下を参照してください: Gemini Image Generation

注: APIキーが設定されていない場合、ツールは自動的に GOOGLE_SERVICE_KEY_FILE で指定されたサービスアカウントを使用して Vertex AI にフォールバックします。そのサービスアカウントには Vertex AI User ロールが付与されている必要があります。

OpenAI

参照: OpenAI Setup

• OPENAI_TITLE_MODEL は現在非推奨となっており、将来のバージョンで削除される予定です。代わりに librechat.yaml 設定内の titleModel エンドポイント設定 を使用してください。
• OPENAI_REVERSE_PROXY は現在非推奨となっており、将来のバージョンで削除される予定です。代わりに カスタムエンドポイント を使用してください。

Assistants

参照: Assistants Setup

注: 利用可能なモデルをカンマ区切り（スペースなし）でカスタマイズできます。最初のモデルがデフォルトになります。空欄にするかコメントアウトすると、内部設定が使用されます。

Tavily

APIキーはこちらから取得してください: https://tavily.com/#api

環境変数:

Traversaal

説明: LLMで強化された検索ツール。

APIキーの取得はこちら: https://api.traversaal.ai/dashboard

環境変数:

WolframAlpha

詳細な手順はこちらをご覧ください: Wolfram Alpha

環境変数:

Zapier

説明: - Zapierアカウントが必要です。APIキーはこちらから取得してください: Zapier

• 許可されたアクションを作成する - Zapierのこの入門ガイドのステップ3に従ってください

注: Zapierは特定のアクションにおいて扱いが難しいことで知られています。メールの下書き作成に使用するのが最も適しているでしょう。

環境変数:

OpenWeather

詳細な手順はこちらをご覧ください: OpenWeather

Code Interpreter

Code Interpreter APIは、コードの実行とファイルの管理を行うための安全な環境を提供します。参照: Code Interpreter API

Artifacts

Artifactsは、HTML/JSコードを安全にレンダリングするためにCodeSandboxライブラリを活用しています。デフォルトでは、CodeSandboxがホストするパブリックCDNが使用されます。

幸いなことに、内部ネットワークの要件がある場合は、フロントエンドコードをコンパイルするバンドラーをセルフホストし、Sandpack用にカスタムバンドラーURLを指定することができます。

メトリクスリクエストが削除されたセルフホスト用の事前構築済みコンテナイメージなど、詳細については以下を参照してください: https://github.com/LibreChat-AI/codesandbox-client

検索 (Meilisearch)

メッセージと会話内の検索を有効にします：

注: Dockerを使用していない場合、無料のセルフホスト型Meilisearchのインストール、または有料のリモートプランが必要です。

MeiliSearchの匿名化されたテレメトリ分析を無効にして完全なプライバシーを確保するには、以下をtrueに設定します：

APIサーバーが検索サーバーに接続するためです。Docker ComposeでMeiliSearchを運用している場合は、'0.0.0.0'を'meilisearch'に置き換えてください。

このマスターキーは、有効なUTF-8文字で構成された16バイト以上のものである必要があります。マスターキーが提供されていない場合、または16バイト未満の場合、MeiliSearchはエラーをスローし、起動を拒否します。MeiliSearchは、安全な自動生成マスターキーを提案します。これはdocker-compose用の既製の安全なキーですが、独自のキーに置き換えることも可能です。

LibreChatがMeilisearchとのデータベースインデックス同期を試みるのを防ぐには、以下の環境変数を true に設定します。これは、ノードクラスターやマルチノード構成において、1つのインスタンスのみがインデックス作成を担当すべき場合に便利です。

RAG API

ドキュメントのインデックス作成とコンテキストを考慮した応答のために、Retrieval-Augmented Generation（RAG）を設定します。詳細は以下を参照してください：RAG API Configuration

注: デフォルトの Docker セットアップを使用する場合、.env ファイルは LibreChat と RAG API 間で共有されます。設定オプションの詳細については、RAG API documentation を参照してください。

音声認識 (Speech to Text) & 音声合成 (Text to Speech)

Speech-to-Text (STT) および Text-to-Speech (TTS) サービスを設定します。詳細は以下を参照してください: Speech Settings

注: STT および TTS は、主に librechat.yaml 内の speech: セクションを通じて設定されます。これらの環境変数は、その設定内で参照されます。YAML 設定オプションの詳細については、Speech Settings を参照してください。

共有リンク

共有会話リンク機能を設定します。

ALLOW_SHARED_LINKS は機能全体のスイッチです。共有リンクを作成できるユーザー、認証済みユーザーと共有できるユーザー、または誰でも閲覧可能にできるユーザーは、ロール権限によって制御されるようになりました。詳細は interface.sharedLinks を参照してください。ALLOW_SHARED_LINKS_PUBLIC は、公開共有リンクを認証なしで閲覧できるかどうかのみを制御します。SHARED_LINKS_SNAPSHOT_FILES は共有リンクのファイルスナップショットに対するグローバルなオーバーライドであり、false に設定するとすべてのリンクに対してスナップショットの提供を無効にできます。

ユーザーシステム

このセクションには、以下の設定が含まれています：

• 自動モデレーション
• 残高/トークン使用量
• 登録とソーシャルログイン
• メールパスワードリセット

モデレーション

自動モデレーションシステムは、ユーザーの違反を追跡するためにスコアリングメカニズムを使用します。ユーザーが過度なログイン、登録、メッセージ送信などの行為を行うと、違反スコアが蓄積されます。設定されたしきい値に達すると、そのユーザーおよびIPアドレスは一時的にBAN（禁止）されます。このシステムは、急激な活動や疑わしい活動を監視およびペナルティを課すことで、プラットフォームのセキュリティを確保します。

参照: Automated Moderation

基本的なモデレーション設定

Banning Settings

ログインおよび登録のレート制限

ログイン試行回数や新規アカウント登録数を制限することで、ブルートフォース攻撃やスパム登録を防止します。

各違反のスコア

注: ブラウザ以外からのアクセスや不正なモデルリクエストは、サードパーティが自動化されたスクリプトを通じてサーバーにアクセスしようとしていることを意味するため、ほとんどの場合、悪意のあるものです。

メッセージレート制限（ユーザーおよびIPごと）

リミッター

注: 両方の制限機能を利用することも可能ですが、デフォルトではIPによる制限のみが適用されます。

IP Limiter:

ユーザー制限機能:

会話インポートのレート制限

ユーザーが会話をインポートできる頻度を制限し、悪用を防ぎます。

注: 両方の制限機能を利用することも可能ですが、デフォルトではIPによる制限のみが適用されます。

IP Limiter:

ユーザー制限機能:

会話のフォーク（分岐）に関するレート制限

ユーザーが会話をフォークできる頻度を制限し、悪用を防ぎます。

注: 両方の制限機能を利用することも可能ですが、デフォルトではIPによる制限のみが適用されます。

IP Limiter:

ユーザー制限機能:

ファイルアップロードのレート制限

ユーザーがファイルをアップロードできる頻度を制限し、悪用を防ぎます。

注: これらは librechat.yaml の rateLimits.fileUploads セクションを通じて設定することも可能です。

IP Limiter:

ユーザー制限機能:

TTS (Text-to-Speech) レート制限

悪用を防ぐため、ユーザーがText-to-Speechを使用できる頻度を制限します。

注: これらは librechat.yaml の rateLimits.tts セクションを通じて設定することも可能です。

IP Limiter:

ユーザー制限機能:

STT (Speech-to-Text) のレート制限

悪用を防ぐため、ユーザーがSpeech-to-Textを使用できる頻度を制限します。

注: これらは librechat.yaml の rateLimits.stt セクション経由で設定することも可能です。

IP Limiter:

ユーザー制限機能:

バランス

以下の機能により、システム内の各endpointにおけるユーザー残高を管理できます。残高を手動で追加するオプションがあるほか、ユーザーの残高を自動的に蓄積するシステムを実装することも可能です。設定で特定の初期残高が定義されている場合、ユーザーが登録した際にトークンが自動的にユーザーの残高へ付与されます。

参照: Token Usage

残高の管理

• npm run add-balance を実行して、手動で残高を追加します。
  • また、追加するメールアドレスとトークンクレジットの量を指定することもできます。例: npm run add-balance [email protected] 1000
• npm run set-balance を実行して、add-balance と同様に手動で残高を設定します。
• npm run list-balances を実行して、すべてのユーザーの残高を一覧表示します。

注: 1000クレジット = $0.001 (0.001米ドル)

登録とログイン

参照: Authentication System

• 一般設定:

Quick Tip: 登録が無効な場合でも、npm run create-user を使用してデータベースに直接ユーザーを追加できます。

Quick Tip: 登録が無効な場合、npm run delete-user [email protected] を使用してユーザーを削除できます。

• セッションおよびリフレッシュトークンの設定:

• 詳細については、こちらをご覧ください：Refresh Token

• JWT設定:

新しい安全な値を使用する必要があります。提供されている例は32バイトのキー（16進数で64文字）です。 これらを素早く生成するには、このreplitを使用してください： JWT Keys

ソーシャルログイン

詳細については、こちらを参照してください: OAuth2-OIDC

Apple認証

詳細については、以下を参照してください： Apple Authentication

Discord認証

詳細については、以下を参照してください：Discord

Facebook認証

詳細については、こちらをご覧ください: Facebook Authentication

GitHub認証

詳細については、以下を参照してください：GitHub Authentication

Google認証

詳細については、以下を参照してください： Google Authentication

OpenID Connect

詳細については、以下を参照してください：

• Auth0
• AWS Cognito
• Azure Entra/AD
• Keycloak

OpenID Connect トークンの再利用

LibreChatは、ユーザー認証状態を管理するために、OpenID Connectプロバイダー（Azure Entra IDやAuth0など）によって発行されたアクセストークンおよびリフレッシュトークンの再利用をサポートしています。この機能が有効な場合、クッキーとしてユーザーに渡されるリフレッシュトークンは、LibreChatではなく、お使いのOpenIDプロバイダーによって発行されます。

OPENID_REUSE_MAX_SESSION_AGE_MS は SESSION_EXPIRY と同様に算術式を受け付けます。プロバイダーがリフレッシュ時に以前のアクセストークンを無効化する場合、MCPサーバーなどのダウンストリームのコンシューマーが有効なベアラートークンを使い終えられるよう、IdPのアクセストークンの有効期間に合わせてこの値を増やしてください。

Microsoft Graph API / Entra ID 統合

Azure Entra ID (旧 Azure AD) を OpenID プロバイダーとして使用する場合、権限および共有システム内での高度なユーザーおよびグループ検索機能のために、追加の Microsoft Graph API 機能を有効にすることができます。

SharePoint 統合

LibreChatは、SharePoint OnlineおよびOneDrive for Businessとの直接統合をサポートしており、ユーザーはSharePointライブラリ内のファイルを会話内で直接選択して添付することができます。このエンタープライズ機能は、既存のAzure Entra ID認証を活用します。

SharePointの構成に関する詳細な手順については、SharePoint Integration Guide を参照してください。

SAML

詳細については、以下を参照してください：

• Auth0

LDAP/AD 認証

詳細については、LDAP/AD Authentication を参照してください。

パスワードのリセット

メールはアカウントの認証およびパスワードのリセットに使用されます。LibreChatは、Mailgun APIと従来のSMTPサービスの両方をサポートしています。参照: Email setup

重要な注意: メール機能を動作させるには、Mailgun（SMTPをブロックするサーバーに推奨）またはSMTPのいずれかを設定する必要があります。

警告: Mailgun または SMTP に有効な値を設定しなかった場合、LibreChat はセキュリティで保護されていないパスワードリセットを使用することになります！

Mailgun 設定 (推奨)

Mailgunは、SMTPポートをブロックしているサーバーへのデプロイにおいて特に有用です。MAILGUN_API_KEY と MAILGUN_DOMAIN の両方が設定されている場合、LibreChatはSMTPの代わりにMailgunを使用します。

SMTP設定

Mailgunが設定されていない場合、LibreChatはSMTP設定にフォールバックします。

警告: EMAIL_SERVICE を使用する場合、以下の拡張接続パラメータは設定しないでください: HOST, PORT, ENCRYPTION, ENCRYPTION_HOSTNAME, ALLOW_SELFSIGNED.

参照: nodemailer well-known-services

Firebase CDN

参照: Firebase CDN Configuration

Amazon S3 および CloudFront

参照: Amazon S3 Configuration および CloudFront with S3

注: Kubernetes デプロイメント（EKS など）の場合、明示的な認証情報を提供する代わりに IRSA (IAM Roles for Service Accounts) を使用できます。その場合、必要なのは AWS_REGION と AWS_BUCKET_NAME のみです。

Azure Blob Storage CDN

参照: Azure Blob Storage CDN Configuration

注: AZURE_STORAGE_CONNECTION_STRING (オプション A) または AZURE_STORAGE_ACCOUNT_NAME と Managed Identity (オプション B) のいずれかを使用してください。両方を同時に使用しないでください。

UI

ヘルプとFAQボタン

動作:

静的ファイルに対する Cache-Control ヘッダーを設定します。これらの設定は、NODE_ENV が production に設定されている場合にのみ有効になります。

キャッシュヘッダーを適切に設定することは、Webアプリケーションのパフォーマンスと効率を最適化するために不可欠です。ブラウザやCDNが静的ファイルのコピーを保持する期間を制御することで、サーバー負荷を大幅に軽減し、ページ読み込み時間を短縮し、全体的なユーザーエクスペリエンスを向上させることができます。

• STATIC_CACHE_MAX_AGE のコメントアウトを解除すると、静的ファイルの max-age を変更できます。デフォルトでは4週間に設定されています。
• STATIC_CACHE_S_MAX_AGE のコメントアウトを解除すると、静的ファイルの s-maxage を変更できます。デフォルトでは1週間に設定されています。
  • これは、CDNやプロキシによって使用される_shared cache_（共有キャッシュ）のためのものです。

アプリのタイトルとフッター

動作:

• CUSTOM_FOOTER のコメントアウトを解除して、カスタムフッターを追加します。
• CUSTOM_FOOTER のコメントアウトを解除し、値を空にするとフッターが削除されます。
• You can now add one or more links in the CUSTOM_FOOTER value using the following format: [Anchor text](URL). Each link should be delineated with a pipe (|).

Markdownの例: CUSTOM_FOOTER=[Link 1](http://example1.com) | [Link 2](http://example2.com)

バースデーハット

動作:

• 2月11日（LibreChatの誕生日）になると、バースデーハットのアイコンが自動的に表示されます。
• SHOW_BIRTHDAY_ICON を false に設定すると、バースデーハットを無効にできます。
• SHOW_BIRTHDAY_ICON を true に設定すると、常にバースデーハットを表示できます。

分析

Google Tag Manager

LibreChatは、分析のためにGoogle Tag Managerをサポートしています。LibreChatで有効にするには、Google Tag Manager IDが必要です。こちらのガイドに従ってGoogle Tag Manager IDを生成し、Google Analyticsを設定してください。その後、ANALYTICS_GTM_ID環境変数をあなたのGoogle Tag Manager IDに設定します。

注意: ANALYTICS_GTM_ID が設定されていない場合、Google Tag Manager は有効になりません。設定が正しくない場合、gtm.js へのリクエストが失敗しているのが確認されます。

会話のインポート

メモリの問題を防ぐため、会話ファイルのインポート制限を設定します。

インラインファイルプレビュー

LibreChatがインラインプレビュー抽出をスキップしてダウンロードのみにする、生成ファイルの最大サイズを制御します。

MCP (Model Context Protocol)

拡張されたサーバー管理とOAuthサポートのために、Model Context Protocol設定を構成します。

MCP Server Configuration

その他

Redis

Redisは、LibreChatに大幅なパフォーマンスの向上をもたらし、水平スケーリング機能を実現します。

注: Redis のサポートは実験的なものであり、使用中に問題が発生する可能性があります。

重要: Redisを使用している場合、LibreChatの設定を変更した後はキャッシュをフラッシュする必要があります。

詳細な設定と例については、以下を参照してください：Redis Configuration Guide

注記:

• USE_REDIS=true の場合、REDIS_URI を指定する必要があります。指定しない場合、アプリケーションはエラーをスローします。
• Redis Clusterモードの場合は、複数のURIを指定してください：redis://node1:7001,redis://node2:7002,redis://node3:7003（クラスターモードは自動的に検出されます）。
• 内部でキーをシャードするシングルエンドポイントのマネージドRedisサービスを使用する場合は、USE_REDIS_CLUSTER=false を維持し、キャッシュのクリア時に CROSSSLOT エラーが発生する場合は REDIS_CLUSTER_SAFE_DELETE=true を設定してください。
• TLS接続には rediss:// プロトコルを使用し、CAがパブリックに信頼されていない場合は REDIS_CA を設定してください。
• REDIS_KEY_PREFIX_VAR と REDIS_KEY_PREFIX は相互に排他的です。
• AWS Elasticache with TLS: Elasticacheでは、TLS接続のために代替の dnsLookup を使用する必要がある場合があります。Elasticache with TLSを使用している場合は、REDIS_USE_ALTERNATIVE_DNS_LOOKUP=true を設定してください。詳細については、ioredis documentation を参照してください。

リーダー選出

Redisを使用したマルチインスタンスデプロイメント向けに、分散リーダー選出を設定します。リーダー選出により、スケジュールされたタスクなどの特定の操作を確実に1つのインスタンスのみが実行するようにします。

注記:

• リーダー選出にはRedisを有効にする必要があります（USE_REDIS=true）。
• これらの設定は、マルチインスタンスデプロイメントの場合にのみ関連します。
• リーダーシップを維持するためには、有効期限が切れる前にリーダーリースを更新する必要があります。
• 最大試行回数後にリース更新が失敗した場合、インスタンスはリーダーシップを放棄します。