約12分 2026年6月22日

Odysseus AI Docker セットアップ: 公開前に確認する 7 つのポイント

Odysseus AI をクローンし、.env を作成し、Compose を起動し、初回管理者パスワードを確認し、ホスト側 Ollama を接続し、データを守り、内部サービスを不用意に公開しないための実用ガイドです。

Odysseus AI Wiki
Odysseus AI Wiki
公開 README、Docker Compose の挙動、ローカルモデル接続、コミュニティのトラブル事例をもとにした非公式編集メモ。
Odysseus AI Docker セットアップのリポジトリ、環境ファイル、Docker Compose、ローカルブラウザを示す図
Docker セットアップは、リポジトリ、環境設定、Compose サービス、ローカルブラウザを分けて確認すると失敗を切り分けやすくなります。

短い答え: 初回セットアップでは Docker Compose がもっとも整理しやすい選択です。公式リポジトリを clone し、.env.example を .env にコピーし、docker compose up -d --build を実行し、localhost:7000 を開き、docker compose logs odysseus で初回管理者パスワードを確認します。公開前に認証、HTTPS、公開ポート、モデル endpoint を必ず見直してください。

このガイドの内容

Docker ルートは、ホスト OS に依存関係を広げずに Odysseus AI のローカルスタックを再現できる点が魅力です。ただし Docker には境界があります。コンテナ内の localhost はホストではなく、ボリュームがデータ保持を決め、補助サービスのポート公開はリスクになります。

Docker を選ぶ理由

Docker ルートは、ホスト OS に依存関係を広げずに Odysseus AI のローカルスタックを再現できる点が魅力です。ただし Docker には境界があります。コンテナ内の localhost はホストではなく、ボリュームがデータ保持を決め、補助サービスのポート公開はリスクになります。

確認順序は、アプリコンテナ、モデル endpoint、ネットワーク公開の順です。コマンド自体は翻訳せず、周辺説明だけをローカライズします。

初回セットアップでは Docker Compose がもっとも整理しやすい選択です。公式リポジトリを clone し、.env.example を .env にコピーし、docker compose up -d --build を実行し、localhost:7000 を開き、docker compose logs odysseus で初回管理者パスワードを確認します。公開前に認証、HTTPS、公開ポート、モデル endpoint を必ず見直してください。

短い答え

初回セットアップでは Docker Compose がもっとも整理しやすい選択です。公式リポジトリを clone し、.env.example を .env にコピーし、docker compose up -d --build を実行し、localhost:7000 を開き、docker compose logs odysseus で初回管理者パスワードを確認します。公開前に認証、HTTPS、公開ポート、モデル endpoint を必ず見直してください。

Docker Compose を確認しやすい順序で起動する

コピーされたコマンドではなく公式リポジトリから始めます。ブランチ、GPU 設定、ポート、サービス名は変わる可能性があります。

Docker Desktop または Docker daemon が起動していること、リポジトリの場所に権限問題がないことを先に確認します。

1. 正しいリポジトリを clone する

公式リポジトリを使い、編集前に main か開発ブランチかを決めます。

git clone https://github.com/pewdiepie-archdaemon/odysseus.git
cd odysseus

2. 環境ファイルを作成する

Compose とアプリが明示的なローカル初期値を読むよう、例ファイルをコピーします。.env は共有しません。

cp .env.example .env

3. スタックを build して起動する

初回 build は image と依存関係を取得するため時間がかかることがあります。完了を待ってから調査します。

docker compose up -d --build

4. 状態と初回認証情報を確認する

コンテナが正常になってからローカル UI を開きます。初回 admin password は Odysseus log に表示されます。

docker compose ps
docker compose logs odysseus

.env、7000 番ポート、実際に到達させる対象を理解する

ブラウザで必要なのは通常 Web UI です。公開 quick start では http://localhost:7000 が基準になります。

Compose の補助サービスは、Web UI が動いたからといって公開入口にしてはいけません。

設定または確認 確認できること 避けること
.env を例からコピー アプリが明示的なローカル設定を読んでいること。 不明なシェル変数で起動すること。
localhost:7000 期待するローカルポートで Web UI に到達できること。 補助サービスをアプリだと思って開くこと。
docker compose ps 各サービスが起動中か失敗状態を示すこと。 アプリが不健康なままモデル設定を変えること。
logs odysseus 起動経路と初回認証情報を確認できること。 パスワードや token を含む log を共有すること。

コンテナの localhost とホスト Ollama を混同せず接続する

Ollama は多くの場合、別のモデルサーバーです。Odysseus がコンテナ内、Ollama がホスト上なら、コンテナ内の localhost はホストではありません。

まずホストで Ollama を確認し、次にコンテナからの到達性を確認してから Odysseus AI に保存します。

Odysseus AI Docker コンテナがホスト上の Ollama に接続する図
よくある失敗は、Ollama がホストにあるのにコンテナ内 localhost を使うことです。
Docker からホスト Ollama へ向かう一般的な endpoint
http://host.docker.internal:11434/v1
Odysseus の場所 Ollama の場所 最初に試す endpoint
Docker コンテナ ホストマシン http://host.docker.internal:11434/v1
Docker コンテナ 同じ Compose ネットワーク Compose のサービス名と内部ポートを使います。
ホストの native プロセス 同じホスト http://127.0.0.1:11434/v1
リモートサーバー 別マシン 生の公開ポートではなく HTTPS または private network を使います。

rebuild、更新、再起動後に残るものを把握する

アカウント、文書、設定が入った workspace は使い捨てではありません。

Compose コマンドは影響が異なります。再起動と volume 削除は別物です。

操作 使う場面 リスク
docker compose restart 既に build 済みでサービスだけ再起動したい場合。 低い。通常は状態が残ります。
docker compose pull && docker compose up -d --build image を更新し現在の source から rebuild する場合。 中。README の注意を先に確認します。
docker compose down コンテナを止めて削除し、volume は残す場合。 多くの場合安全ですが Compose を確認します。
docker compose down -v 意図的に volume を削除し初期化する場合。 高い。workspace 状態を削除できます。

初回起動のトラブルシューティング表

build、コンテナ状態、ブラウザ到達、認証情報、モデル接続を分けて、最初に失敗した層から直します。

症状 考えられる原因 最初の修正
Docker コマンドが認識されない Docker Desktop または daemon が未インストール、未起動、または shell から使えません。 Docker を起動し、rebuild 前に docker version を確認します。
build 成功後 localhost:7000 が開かない コンテナ起動中、別ポート、またはサービス不健康です。 docker compose ps と logs odysseus を確認します。
初回 admin password が見えない log が流れた、既存状態がある、または .env に設定があります。 logs odysseus と .env を確認します。
Ollama はホストで動くが Odysseus から失敗する コンテナが host gateway ではなく localhost を使っています。 host.docker.internal:11434/v1 を使い、同じ実行層から試します。
cleanup 後にデータが消えた volume が削除されました。 backup から復元し、意図しない down -v を避けます。

LAN、tunnel、reverse proxy 前の安全チェック

self-hosted AI workspace はファイル、prompt、文書、モデル、tool に触れる可能性があります。

必要な UI だけを公開し、内部サービスは非公開にし、認証情報を変え、遠隔アクセスには HTTPS を使います。

  1. 外部アクセス前に admin 認証情報を変更します。
  2. Compose の host port binding を確認します。
  3. ChromaDB、モデルサーバー、補助サービスを公開しません。
  4. HTTPS と信頼できる proxy を使います。
  5. .env、log、secret が写る screenshot を公開しません。
  6. 更新や破壊的 cleanup 前に volume を backup します。
安全な初期値

認証、port、HTTPS、firewall、model endpoint を確認するまでは localhost に留めます。

FAQ

初回の clean install では多くの場合そうです。GPU や開発用途では native path が向く場合もあります。

.env で変更していなければ http://localhost:7000 です。

docker compose logs odysseus で確認します。既存状態や .env によって変わることがあります。

どちらも可能です。Docker からホスト Ollama へは host.docker.internal:11434/v1 を使うことが多いです。

推奨しません。auth、HTTPS、firewall、補助サービスを先に確認します。

volume を backup し、README を確認し、volume 削除は reset 目的のときだけ使います。

参考資料

  1. Official Odysseus AI GitHub repository - Current README, Docker quick start, feature list, and security notes.
  2. Docker Compose documentation - Reference for Compose commands, services, networks, and volumes.
  3. Docker Desktop networking documentation - Host-to-container and container-to-host networking behavior.
  4. Ollama API documentation - Endpoint checks for local model server connectivity.

関連ガイド

最終更新: 2026年6月22日

Odysseus AI Wiki に戻る