外部 Ollama と Docker を使う

ホスト、別のサーバー、または Tailscale/LAN 上のマシンですでに Ollama を実行している場合は、この構成を使用します。

Work の利用可否

この Compose 構成では Ollama の実行場所が変わりますが、Work はマウントされたホストの Docker ソケットを通じて引き続き有効です。この構成は Libre WebUI に Docker ホストの root と同等の制御権限を与えるため、 Libre WebUI の管理者が、信頼できるホスト管理者でもある環境でのみ使用してください。Linux では、ソケットを所有するグループに合わせて .env の DOCKER_GID を設定します。Work が不要な場合はマウントを削除してください。 Work：隔離されたワークスペースも参照してください。

前提条件

Ollama へ接続できることを確認します。

curl http://localhost:11434/api/version

新しいインスタンスの場合は、モデルを取得します。

ollama pull gemma4:12b

Libre WebUI を起動する

リポジトリのルートから実行します。

docker compose -f docker-compose.external-ollama.yml up -d

http://localhost:8080 を開きます。

Compose ファイルでは、既定で OLLAMA_BASE_URL が http://host.docker.internal:11434 を指します。

Ollama の URL を変更する

別のホストを使う場合：

OLLAMA_BASE_URL=http://192.168.1.100:11434 docker compose -f docker-compose.external-ollama.yml up -d

host.docker.internal を名前解決できない Linux ホストでは、次の設定をサービスに追加します。

extra_hosts:
  - 'host.docker.internal:host-gateway'

データの永続化

Compose ファイルは Libre WebUI のデータを Docker ボリュームに保存します。

libre_webui_data
libre_webui_temp

本番環境では固定のシークレットを設定します。

JWT_SECRET=replace-with-a-long-random-secret
ENCRYPTION_KEY=replace-with-64-hex-characters

データボリュームと暗号化キーは必ず一緒にバックアップしてください。

ネットワークアクセス

リポジトリの Compose ファイルでは、現在 CORS_ORIGIN が直接設定されています。シェルまたは .env ファイルで値を設定しても、そのリテラルは置き換わりません。libre-webui.environment の項目を編集するか、たとえば compose.origin.yml のような明示的な Compose オーバーライドを追加します。

services:
  libre-webui:
    environment:
      CORS_ORIGIN: http://localhost:8080,http://192.168.1.50:8080
      BASE_URL: http://192.168.1.50:8080

両方のファイルを適用します。

docker compose \
  -f docker-compose.external-ollama.yml \
  -f compose.origin.yml \
  up -d

公開ドメインでは、両方の値に同一の正確な HTTPS オリジンを使用し、通信を HTTPS で終端してください。

よく使うコマンド

docker compose -f docker-compose.external-ollama.yml ps
docker compose -f docker-compose.external-ollama.yml logs -f libre-webui
docker compose -f docker-compose.external-ollama.yml restart
docker compose -f docker-compose.external-ollama.yml pull
docker compose -f docker-compose.external-ollama.yml up -d

トラブルシューティング

Libre WebUI から Ollama に接続できない

docker compose -f docker-compose.external-ollama.yml exec libre-webui \
  wget -O- http://host.docker.internal:11434/api/version

失敗する場合は、OLLAMA_BASE_URL に LAN/Tailscale の明示的な IP アドレスを指定します。

モデルが表示されない

Ollama ホストを確認します。

ollama list

モデルマネージャーは、設定された Ollama インスタンスから情報を読み取ります。

CORS エラー

CORS_ORIGIN がスキームとポートを含む正確なブラウザーオリジンと一致していることを確認します。

Work の利用可否​

前提条件​

Libre WebUI を起動する​

Ollama の URL を変更する​

データの永続化​

ネットワークアクセス​

よく使うコマンド​

トラブルシューティング​

関連ドキュメント​