約11分 2026年6月18日

Odysseus AI Windows セットアップ: WSL2、Docker、Ollama

WSL2 または Docker Desktop で Odysseus AI を動かし、Ollama の localhost 混乱を避け、公開前にポート、認証情報、ファイアウォールを確認するための Windows 向けガイドです。

Odysseus AI Wiki
Odysseus AI Wiki
Odysseus AI Wiki editorial notes for Windows self-hosted setup.
Odysseus AI Windows セットアップ: WSL2、Docker、Ollama
Windows での Odysseus AI は、まず WSL2 を Linux レイヤーとして使い、分離が必要なときだけ Docker Desktop を足し、Ollama は接続前に単独で確認するのが安全です。localhost は Windows、WSL2、Docker で意味が変わります。

Short answer: Windows での Odysseus AI は、まず WSL2 を Linux レイヤーとして使い、分離が必要なときだけ Docker Desktop を足し、Ollama は接続前に単独で確認するのが安全です。localhost は Windows、WSL2、Docker で意味が変わります。

In this guide

Windows でも Odysseus AI は動かせますが、単純な Linux や macOS の手順より境界が増えます。ブラウザは Windows、シェルは WSL2、コンテナは Docker Desktop、Ollama は別プロセスという構成になりがちです。このガイドでは、アプリ本体、モデル endpoint、ネットワーク境界を順番に確認します。

Windows の選び方

Windows で Linux に近い開発環境を使いたいなら、最初は WSL2 が扱いやすいです。リポジトリのコマンドや依存関係の挙動が読みやすくなります。

Docker Desktop は、隔離された再現性のあるテストをしたいときに有効です。ただし Odysseus AI とホスト側 Ollama の間にネットワーク境界が増えます。

Recommended first pass

Windows での Odysseus AI は、まず WSL2 を Linux レイヤーとして使い、分離が必要なときだけ Docker Desktop を足し、Ollama は接続前に単独で確認するのが安全です。localhost は Windows、WSL2、Docker で意味が変わります。

Windows と WSL2 の準備

起動前に、仮想化、WSL2、Docker Desktop の WSL2 backend を確認します。

リポジトリはできれば WSL のホーム配下に置き、/mnt/c や同期フォルダでの権限問題を避けます。

1. Enable the Linux layer

Install or update WSL2, then use a mainstream distribution such as Ubuntu for the first test.

wsl --install
wsl --update
wsl -l -v

2. Clone inside WSL2

Keep the repository in the Linux home directory for fewer permission surprises.

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

3. Install dependencies from the project instructions

Follow the current README or setup script rather than mixing instructions from older posts.

# Verify commands on the official repository before running them

4. Open the local UI from Windows

When the app reports a local port, open that address in the Windows browser and confirm the first screen before configuring model providers.

http://127.0.0.1:7860

Docker Desktop の流れ

Docker Desktop は依存関係を隔離して、クリーンな起動確認をするのに向いています。

ただしコンテナ内の localhost はコンテナ自身です。Windows ホストの Ollama へは host.docker.internal などを検討します。

Setup path Best for Watch this
WSL2 process Linux-like install flow, easy shell debugging, fewer container layers Keep files in the WSL filesystem and verify the browser port from Windows.
Docker Desktop Disposable test runs, isolated dependencies, deployment rehearsal Use the correct host endpoint when the container needs a Windows-hosted service.
Windows-only shell Small helper commands after the stack is working Many Linux-oriented setup assumptions are easier inside WSL2.

Ollama の接続先

Ollama は Windows、WSL2、別コンテナのどこでも動き得ます。Odysseus AI から届く endpoint かどうかを確認してください。

モデル設定に入れる前に、同じ実行レイヤーから curl で応答を確認します。

Where Odysseus AI runs Where Ollama runs Endpoint to try first
WSL2 Windows host http://127.0.0.1:11434 or the Windows host gateway, depending on WSL networking
Docker container Windows host http://host.docker.internal:11434
WSL2 Same WSL2 distro http://127.0.0.1:11434
Docker container Another container Use the Docker network service name rather than localhost
Quick endpoint smoke test
curl http://127.0.0.1:11434/api/tags

トラブル対応表

まずアプリのポート、その後モデル endpoint という順番で境界ごとに確認します。

Symptom Likely cause First fix
The browser cannot open the Odysseus AI page The app is listening on a different port, bound only inside WSL2, or blocked by a Windows firewall prompt. Check the app log for the exact port, open 127.0.0.1 from Windows, and allow the local firewall prompt only for trusted networks.
Ollama works in Windows but not inside Docker The container is using localhost, which points back to itself. Try host.docker.internal:11434 from inside the container or move Ollama into the same Docker network.
File changes are slow or permissions look strange The repository is stored under /mnt/c or a synced Windows folder. Move the repo to the WSL home directory and reinstall dependencies there.
Login or admin password is unclear A generated credential was missed in setup logs or an old local state is being reused. Review the current setup output, rotate temporary credentials, and avoid posting secrets in screenshots.
Docker Desktop starts but containers cannot reach models The model server is bound to a host interface the container cannot access. Verify the model server bind address and test with curl from the same runtime layer.

安全チェック

最初の成功は localhost に閉じておきます。プロンプト、文書、キー、ローカルパスが含まれる可能性があります。

リモート公開は、認証、TLS、リバースプロキシ、ファイアウォールを理解してからにします。

  1. Use official repository commands for the install path you are actually running.
  2. Record whether Odysseus AI is running in WSL2, Docker Desktop, or another host before changing endpoints.
  3. Test the app UI and the Ollama endpoint separately before connecting them.
  4. Change any temporary or generated admin credential after the first login.
  5. Keep the first run bound to local addresses unless you deliberately configure secure remote access.
  6. Do not publish screenshots that include API keys, generated passwords, local file paths, or private document names.
Safe default

Windows での Odysseus AI は、まず WSL2 を Linux レイヤーとして使い、分離が必要なときだけ Docker Desktop を足し、Ollama は接続前に単独で確認するのが安全です。localhost は Windows、WSL2、Docker で意味が変わります。

FAQ

Use WSL2 for the first serious Windows setup. It matches Linux-oriented repository commands more closely and avoids many path and permission problems that appear when scripts are run from ordinary Windows folders.

Docker Desktop is useful but not always required. Use it when you want an isolated container run or deployment rehearsal. If your goal is local model experimentation with fewer layers, WSL2 may be easier to debug.

The two processes may not share the same localhost. Windows, WSL2, and Docker containers each have their own networking context. Test the Ollama endpoint from the same layer where Odysseus AI runs.

Allow only the scope you need for local testing. A private-network prompt may be reasonable for a trusted home machine, but public exposure should wait until authentication, TLS, and reverse proxy rules are deliberate.

Start with the layer that fails earliest: WSL2 availability, repository checkout, dependency install, app port, browser access, then model endpoint. Do not edit every setting at once.

References

  1. Official Odysseus AI GitHub repository - Use the project repository as the source of truth for current setup scripts and README changes.
  2. Microsoft WSL installation documentation - Official Windows guidance for installing and updating WSL2.
  3. Docker Desktop WSL backend documentation - Explains how Docker Desktop integrates with WSL2 on Windows.
  4. Ollama API documentation - Useful for checking whether the local model server endpoint responds before connecting it to Odysseus AI.

Related guides

2026年6月18日

Back to Odysseus AI Wiki