v0.3.0 — Windows 11 + winget installation 
██╗  ██╗ ██████╗ ██████╗ ██████╗  █████╗     ██╗    ██╗███████╗██╗     
██║ ██╔╝██╔═══██╗██╔══██╗██╔══██╗██╔══██╗    ██║    ██║██╔════╝██║     
█████╔╝ ██║   ██║██║  ██║██████╔╝███████║    ██║ █╗ ██║███████╗██║     
██╔═██╗ ██║   ██║██║  ██║██╔══██╗██╔══██║    ██║███╗██║╚════██║██║     
██║  ██╗╚██████╔╝██████╔╝██║  ██║██║  ██║    ╚███╔███╔╝███████║███████╗
╚═╝  ╚═╝ ╚═════╝ ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝     ╚══╝╚══╝ ╚══════╝╚══════╝

Agentic Azure on
Windows + WSL

Cloud-native CLI tools, Docker CE, and AI assistance—running natively in WSL2. From fresh Windows install to azd up in minutes.

Get Started Kodra Desktop
Before You Begin

Windows Prerequisites

Complete these steps on Windows before running the installer in WSL

1

Windows Terminal

Modern terminal with tabs, split panes, and full Unicode support.

winget install Microsoft.WindowsTerminal
2

WSL2 + Ubuntu

Windows Subsystem for Linux with Ubuntu 24.04. Run in PowerShell as Admin:

wsl --install -d Ubuntu-24.04
3

Nerd Font

Required for terminal icons. Then set font in Terminal settings.

winget install DEVCOM.JetBrainsMonoNerdFont
4

VS Code + Extensions

Install on Windows. Required extensions: WSL, GitHub Copilot.

winget install Microsoft.VisualStudioCode

Prerequisites complete? Run this in Windows Terminal → Ubuntu:

Windows Terminal — Ubuntu (WSL)
$ wget -qO- https://kodra.wsl.codetocloud.io/boot.sh | bash
✓ Azure CLI + azd installed
✓ Docker CE configured for WSL2
✓ GitHub CLI + Copilot ready
✓ Shell configured with Starship

Done in 3m 45s — Run kodra doctor to verify

Why WSL?

The best of both worlds: Windows for your desktop apps and WSL2 for Linux development. Native Docker performance, real Linux tooling, and seamless integration with VS Code.

Native Linux Performance Real Linux kernel via Hyper-V, not emulation. Docker runs at full speed.
No Docker Desktop License Docker CE runs free in WSL2—no licensing concerns for any organization size.
VS Code Integration Edit code in Windows, run in Linux. Dev Containers just work.
Same Tools as CI/CD Match your GitHub Actions environment locally. No more "works on my machine."
Supported
WSL2 + Ubuntu 24.04
Windows 11
Looking for native Ubuntu?

Kodra Desktop gives you full GNOME theming, Ghostty terminal, and window tiling on native Ubuntu.

Features

CLI-first for WSL

All the tools you need for Azure development—optimized for the WSL environment.

☁️

Azure-Native

Azure CLI, azd, Bicep, Terraform, OpenTofu, and PowerShell 7—all configured and ready to deploy.

🤖

AI-Assisted

GitHub Copilot in VS Code and the CLI. Ask questions, generate code, explain errors.

🐳

Docker CE Native

Docker running directly in WSL2—no Docker Desktop needed. Free for all use cases.

☸️

Kubernetes

kubectl, Helm, and k9s for managing AKS clusters with style.

⚡

Modern Shell

Zsh with Starship prompt, Nerd Fonts support, and intelligent aliases.

🔗

VS Code Integration

Seamless connection from Windows VS Code to your WSL environment.

Docker

Docker CE in WSL2

Native Docker performance without Docker Desktop licensing concerns.

🐳 Why Docker CE in WSL2?

Docker Desktop requires a paid license for organizations with more than 250 employees or $10M+ revenue. Kodra WSL configures Docker CE to run natively in WSL2—completely free.

💰
Free Forever No licensing fees, regardless of organization size
🚀
Native Performance Runs directly in Linux kernel, not through virtualization layers
💻
Lower Resource Usage No separate Docker Desktop app consuming RAM
🔧
CI/CD Parity Same Docker experience as your build pipelines
Batteries Included

The complete CLI toolkit

25+ carefully selected tools, configured for WSL2.

🐚
Zsh
⚡
Starship
☁️
Azure CLI
🚀
azd
💪
Bicep
🏗️
Terraform
🪨
OpenTofu
🐳
Docker CE
☸️
kubectl
⎈
Helm
🐙
k9s
🐱
GitHub CLI
🤖
Copilot CLI
🦇
bat
📂
eza
🔍
fzf
🔎
ripgrep
📊
btop
🎯
lazygit
CLI

Simple commands

Manage your setup with memorable commands.

kodra doctor Check system health & WSL status
kodra update Update all tools
kodra setup Re-run first-time setup
kodra fetch Show system info