Docker

ほとんどのシナリオにおいて、Docker Composeはシンプルで使いやすく、信頼性が高いため、推奨されるインストール方法です。

前提条件

• Git
• Docker

ほとんどのユーザーには Docker Desktop が推奨されます。リモートサーバーへのインストールについては、Ubuntu Docker Deployment Guide を参照してください。

services:
  mongodb:
    image: mongo:4.4.18

インストール

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

cp .env.example .env

docker compose up -d

librechat.yaml のマウント

Dockerでカスタムの librechat.yaml 設定ファイルを使用するには、コンテナからアクセスできるようにボリュームとしてマウントする必要があります。

サンプルオーバーライドファイルをコピーして編集します：

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

docker-compose.override.yml 内の librechat.yaml ボリュームマウントのコメントアウトが解除されていることを確認してください：

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

変更を反映させるには再起動してください:

docker compose down && docker compose up -d

ファイルをゼロから作成する方法を含む完全なセットアップ手順については、librechat.yaml ガイドを参照してください。その他のオーバーライドオプションについては、Docker オーバーライドガイドを参照してください。

LibreChat の更新

以下のコマンドを実行すると、Docker composeファイルの必要な変更を含むLibreChatプロジェクトの最新の変更と、最新のビルド済みイメージが取得されます。

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

トラブルシューティング

ポートが既に使用されています

ポート3080で bind: address already in use のようなエラーが表示される場合、別のアプリケーションがそのポートを使用しています。

競合しているアプリケーションを停止するか、docker-compose.override.yml でポートを変更してください。

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

その場合は、代わりに http://localhost:3081 にアクセスしてください。

コンテナが起動時にクラッシュする

コンテナが起動直後に終了してしまう場合は、ログを確認してください：

docker compose logs api

一般的な原因:

• librechat.yaml の構文が無効です -- YAML Validator で検証してください
• .env ファイルが見つかりません -- プロジェクトのルートディレクトリに .env が存在することを確認してください
• Dockerが実行されていません -- Docker Desktopが開いて実行されていることを確認してください

不足している環境変数

機能が期待通りに動作しない場合は、必要な環境変数が .env ファイルに設定されていることを確認してください。

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

利用可能なすべての変数とそのデフォルト値については、.env reference を参照してください。

次のステップ