11 Min. Lesezeit 18. Juni 2026

Odysseus AI unter Windows: WSL2, Docker Desktop und Ollama

Praktische Windows-Anleitung für Odysseus AI mit WSL2 oder Docker Desktop, sauberer Ollama-Routenwahl und Prüfungen für Ports, Zugangsdaten und Firewall.

Odysseus AI Wiki
Odysseus AI Wiki
Odysseus AI Wiki editorial notes for Windows self-hosted setup.
Odysseus AI unter Windows: WSL2, Docker Desktop und Ollama
Für Windows ist WSL2 meist der beste erste Layer. Docker Desktop ist sinnvoll für isolierte Tests, und Ollama sollte separat erreichbar sein, bevor es in Odysseus AI eingetragen wird. localhost meint in Windows, WSL2 und Docker nicht immer dieselbe Umgebung.

Short answer: Für Windows ist WSL2 meist der beste erste Layer. Docker Desktop ist sinnvoll für isolierte Tests, und Ollama sollte separat erreichbar sein, bevor es in Odysseus AI eingetragen wird. localhost meint in Windows, WSL2 und Docker nicht immer dieselbe Umgebung.

In this guide

Odysseus AI kann auf Windows gut laufen, aber die Umgebung besteht oft aus mehreren Schichten: Windows-Browser, WSL2-Shell, Docker-Container und Ollama-Server. Dieser Leitfaden trennt diese Ebenen, damit App, Modell-Endpunkt und Netzwerk nacheinander geprüft werden.

Windows-Pfad wählen

Beginnen Sie mit WSL2, wenn Sie eine Linux-ähnliche Umgebung auf Windows brauchen.

Docker Desktop eignet sich für isolierte, wiederholbare Tests, bringt aber eine zusätzliche Netzwerkgrenze mit.

Recommended first pass

Für Windows ist WSL2 meist der beste erste Layer. Docker Desktop ist sinnvoll für isolierte Tests, und Ollama sollte separat erreichbar sein, bevor es in Odysseus AI eingetragen wird. localhost meint in Windows, WSL2 und Docker nicht immer dieselbe Umgebung.

Windows und WSL2 vorbereiten

Prüfen Sie vor dem Start Virtualisierung, WSL2 und bei Bedarf das Docker-Desktop-WSL2-Backend.

Klonen Sie das Repository möglichst in das WSL-Dateisystem, nicht in einen synchronisierten Windows-Ordner.

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-Ablauf

Docker Desktop ist gut für saubere Container-Tests und spätere Deployment-Proben.

Im Container meint localhost den Container. Für Ollama auf dem Windows-Host ist oft host.docker.internal nötig.

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-Endpunkte

Ollama kann auf Windows, in WSL2 oder in einem Container laufen. Entscheidend ist die Erreichbarkeit aus der Odysseus-AI-Schicht.

Testen Sie den Endpoint mit curl, bevor Sie ihn in den Workspace eintragen.

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

Fehlersuche

Prüfen Sie zuerst App-Port und Browserzugriff, danach den Modell-Endpunkt.

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.

Sicherheitscheck

Lassen Sie den ersten erfolgreichen Lauf lokal, da Prompts, Dokumente und Schlüssel im Workspace liegen können.

Remote-Zugriff erst nach bewusster Konfiguration von Authentifizierung, TLS, Proxy und Firewall aktivieren.

  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

Für Windows ist WSL2 meist der beste erste Layer. Docker Desktop ist sinnvoll für isolierte Tests, und Ollama sollte separat erreichbar sein, bevor es in Odysseus AI eingetragen wird. localhost meint in Windows, WSL2 und Docker nicht immer dieselbe Umgebung.

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

18. Juni 2026

Back to Odysseus AI Wiki