WSL UI

A lightweight desktop application to manage Windows Subsystem for Linux (WSL)
distributions.

Built with Tauri (Rust) and React
(TypeScript).

Developed by Octasoft Ltd

Features

• Dashboard - View all distributions with real-time status, CPU, memory, and disk usage
• Quick Actions - Terminal, file explorer, IDE, restart, export, clone
• Install from Anywhere - Microsoft Store, Docker/Podman images, LXC catalog, custom URLs
• Backup & Restore - Export, import, and clone distributions
• Custom Actions - Define reusable commands with variable substitution
• WSL Settings - Edit .wslconfig and wsl.conf from a visual interface
• 17 Themes - Dark, light, and custom themes with live preview
• System Tray - Minimize to tray for quick access
• Disk Mounting - Mount VHD files and physical disks into WSL

See the User Guide for detailed features and screenshots.

Installation

From Microsoft Store

From Releases

Download the latest installer from the
Releases page.

From Source

Prerequisites: Node.js v18+,
Rust, Windows (not WSL)

git clone https://github.com/octasoft-ltd/wsl-ui.git
cd wsl-ui
npm install
npm run tauri dev

Documentation

• User Guide - Features, screenshots, and how-to guides
• Troubleshooting - Solutions to common issues
• Privacy Policy - How we handle your data (we don't collect any)
• Contributing - How to contribute to the project

Development

Project Structure

wsl-ui/
├── src/                    # React frontend
│   ├── components/         # UI components
│   ├── services/           # Tauri API wrappers
│   ├── store/              # Zustand state management
│   └── test/e2e/           # WebDriverIO E2E tests
├── src-tauri/              # Rust backend
│   └── src/                # Tauri commands and WSL logic
└── crates/wsl-core/        # Shared WSL parsing library

Tech Stack

Scripts

npm run tauri dev       # Development mode
npm run tauri build     # Production build
npm run test:run        # Unit tests
npm run test:e2e:dev    # E2E tests (mock mode)

License

This project is licensed under the Business Source License 1.1 (BUSL-1.1) -
see the LICENSE file for details.

• Free for personal use and organizations with less than $1M annual revenue
• Converts to Apache 2.0 four years after each version is published
• Commercial licensing available: wsl-ui@octasoft.co.uk

Trademark Notice

"WSL UI" and "Octasoft" are trademarks of Octasoft Ltd. See the
TRADEMARK file for usage requirements for forks and derivative works.

Links

• Report Issues
• Security Policy
• Changelog
• Credits