kandev/docs/windows_support.md

Windows Support (WSL)

Kandev runs on Windows through WSL (Windows Subsystem for Linux).

Prerequisites

• Windows 10 (version 2004+) or Windows 11
• WSL 2 with a Linux distribution installed (Ubuntu recommended)

Setup

1. Install WSL

From PowerShell (as Administrator):

wsl --install

Restart your machine if prompted, then open your Linux distribution from the Start menu.

2. Install system dependencies

sudo apt update
sudo apt install build-essential libatomic1 git

• build-essential provides gcc, required by go-sqlite3 (CGO)
• libatomic1 is required by Node.js

3. Install mise (runtime manager)

curl https://mise.run | sh

Add mise to your shell profile:

echo 'eval "$(~/.local/bin/mise activate bash)"' >> ~/.bashrc
source ~/.bashrc

4. Install runtimes

mise use -g node
mise use -g pnpm
mise use -g go

5. Clone and install

git clone <repo-url> kandev
cd kandev
make install

6. Run

make dev    # development mode
make start  # production mode

Troubleshooting

libatomic.so.1: cannot open shared object file

Node.js requires libatomic1. Install it:

sudo apt install libatomic1

pnpm: command not found

Ensure pnpm is installed and activated via mise:

mise use -g pnpm

Binary was compiled with 'CGO_ENABLED=0', go-sqlite3 requires cgo

The SQLite driver needs a C compiler. Install build-essential:

sudo apt install build-essential

Browser doesn't auto-open

WSL interop must be enabled so the CLI can launch your Windows browser. Ensure /etc/wsl.conf contains:

[interop]
enabled=true
appendWindowsPath=true

Then restart WSL from PowerShell:

wsl --shutdown

cd: can't cd to apps during make install

This is a symptom of pnpm not being installed. Follow step 4 above.