Skip to main content

Windows Installation

O.D.I.N. runs on Windows 10/11 via Docker Desktop with the WSL2 backend.

Prerequisites​

RequirementDetails
Windows10 (build 19041+) or 11
Docker DesktopLatest, with WSL2 backend enabled
RAM2 GB available for the container
Disk10 GB
warning

Docker Desktop must be running with the WSL2 backend, not the legacy Hyper-V backend. You can check this in Docker Desktop under Settings > General > Use the WSL 2 based engine.

Quick Install​

Open PowerShell as Administrator and run:

irm https://raw.githubusercontent.com/HughKantsime/runsodin/master/install/install.ps1 | iex

This downloads the Docker Compose file, creates the data directory, and starts O.D.I.N.

Manual Install​

If you prefer to do it step by step in PowerShell:

mkdir odin
cd odin
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HughKantsime/runsodin/master/docker-compose.yml" -OutFile "docker-compose.yml"
docker compose up -d

Once the container is running, open your browser to:

http://localhost:8000

Common Windows Issues​

WSL2 not enabled​

If Docker Desktop won't start or shows a WSL2 error:

wsl --install

Reboot after installation. Then re-launch Docker Desktop.

Docker Desktop not running​

The O.D.I.N. container requires Docker Desktop to be running. If docker compose up -d fails with a connection error, open Docker Desktop and wait for it to finish starting.

Firewall blocking ports​

Windows Defender Firewall may block ports 8000, 1984, and 8555. If you can't reach the UI from another device on your network, add inbound rules:

New-NetFirewallRule -DisplayName "ODIN Web" -Direction Inbound -Port 8000 -Protocol TCP -Action Allow
New-NetFirewallRule -DisplayName "ODIN go2rtc" -Direction Inbound -Port 1984 -Protocol TCP -Action Allow
New-NetFirewallRule -DisplayName "ODIN WebRTC" -Direction Inbound -Port 8555 -Protocol UDP -Action Allow

Accessing from other devices​

By default, localhost:8000 only works from the Windows machine itself. To access O.D.I.N. from other devices on your network, use the machine's LAN IP address (e.g., http://192.168.1.100:8000).

Updating​

Open PowerShell in your odin directory:

docker compose pull
docker compose up -d

Full Guide​

For additional details and troubleshooting, see the Windows Install Guide in the repository.