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://get.runsodin.com/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.