Windows Installation¶

Stackvo runs on WSL2 (Windows Subsystem for Linux 2) on Windows. This guide detailedly explains the steps for WSL2 installation, Docker Desktop configuration, and running Stackvo within WSL2 on Windows 10 and Windows 11. Thanks to WSL2, you get a Linux-like experience.

WSL2 Installation¶

Automatic Installation (Recommended)¶

Open PowerShell as Administrator:

# Install WSL2 (single command)
wsl --install

# Restart computer
Restart-Computer

First Launch¶

1. Open "Ubuntu" from Start menu
2. Enter username (lowercase, no spaces)
3. Set password (2 times)

Docker Desktop Installation¶

1. Downloading Docker Desktop¶

Download Docker Desktop for Windows.

2. Installation¶

1. Run the downloaded .exe file
2. Check "Use WSL 2 instead of Hyper-V" option
3. Click "Install"
4. Restart computer when installation is complete

3. Docker Desktop Settings¶

Settings → General: - ✅ Use the WSL 2 based engine

Settings → Resources → WSL Integration: - ✅ Enable integration with my default WSL distro - ✅ Ubuntu-22.04

Settings → Resources:

Apply & Restart

Stackvo Installation (Inside WSL2)¶

Login to WSL2¶

# Switch to WSL2 from PowerShell
wsl

System Update¶

# Inside Ubuntu
sudo apt update && sudo apt upgrade -y
sudo apt install -y git curl jq

Stackvo Installation¶

After Docker Desktop installation is complete, follow the Quick Start page to install Stackvo.

Summary:

# Inside WSL2
git clone https://github.com/stackvo/stackvo.git
cd stackvo

# Configuration
cp .env.example .env

# Start
./stackvo.sh generate
./stackvo.sh up

Hosts File (Windows)¶

Open Notepad as administrator on Windows:

C:\Windows\System32\drivers\etc\hosts

Add:

127.0.0.1  stackvo.loc
127.0.0.1  traefik.stackvo.loc

Installation Verification¶

WSL2 Check¶

# In PowerShell
wsl --list --verbose

# Output:
#   NAME            STATE           VERSION
# * Ubuntu-22.04    Running         2

Docker Check¶

# Inside WSL2
docker --version
docker compose version
docker ps

Web UI Check¶

Open in Windows browser:

• Stackvo Dashboard: https://stackvo.loc
• Traefik Dashboard: http://traefik.stackvo.loc

Common Issues¶

WSL2 Not Starting¶

Error: WslRegisterDistribution failed with error: 0x80370102

Solution: Virtualization must be enabled in BIOS

# Enable Hyper-V
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All
Restart-Computer

Docker Daemon Cannot Connect¶

Solution: 1. Check if Docker Desktop is running 2. Is Settings → Resources → WSL Integration enabled? 3. Restart WSL2: wsl --shutdown → wsl

Port Conflict¶

# Find conflicting service on Windows
netstat -ano | findstr :80

# Stop process
taskkill /PID <PID> /F