DocsInstallation / Windows
Windows Installation
Choose between Docker Desktop (Easiest) or Docker Engine (Free/Advanced).
Step 1: Choose Your Docker Setup
Orrerygen requires a Docker runtime. On Windows, you have two choices:
Option A: Docker Desktop
- Easiest setup
- GUI dashboard
- Paid license required for large companies
Option B: Docker Engine (WSL2)
- Free for everyone
- Lightweight & Fast
- Requires Command Line setup
Option A: Docker Desktop
- Download Docker Desktop from docker.com.
- Run the installer. Ensure "Use WSL 2 instead of Hyper-V" is checked.
- Restart your computer.
- Open PowerShell and verify:
docker --version.
Option B: Docker Engine (WSL2 Only)
1. Install WSL2 & Ubuntu
Open PowerShell as Administrator and run:
wsl --install
Restart your computer if prompted. This installs Ubuntu by default.
2. Install Docker in Ubuntu
Open your new "Ubuntu" app (terminal) and run these commands one by one:
# 1. Update & Install Prerequisites
sudo apt-get update
sudo apt-get install ca-certificates curl gnupg
# 2. Add Docker's Official GPG Key
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg
# 3. Set up Repository
echo "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
# 4. Install Docker Engine
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo apt-get update
sudo apt-get install ca-certificates curl gnupg
# 2. Add Docker's Official GPG Key
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg
# 3. Set up Repository
echo "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
# 4. Install Docker Engine
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
3. Post-Install configuration
Still in Ubuntu terminal:
# Add your user to docker group (avoids using sudo)
sudo usermod -aG docker $USER
# Apply membership (or just close/reopen terminal)
newgrp docker
# Start Docker Daemon
sudo service docker start
sudo usermod -aG docker $USER
# Apply membership (or just close/reopen terminal)
newgrp docker
# Start Docker Daemon
sudo service docker start
Orrerygen Auto-Connect
You do not need to manually expose Docker to Windows. Orrerygen Desktop detects your WSL distro and will automatically bridge the connection.
Step 2: Install Orrerygen
Download the Installer
Latest Stable Build • Windows 10/11 (64-bit)
Installation Steps:
- Run the
Orrerygen-Setup-1.0.0.exeinstaller. - Follow the on-screen prompts to complete installation.
- Launch Orrerygen Desktop from the Start Menu.
Firewall WarningWindows Firewall may ask for permission. Allow access so the desktop app can talk to the agent containers.