# WSL Manager

A macOS app for managing native Linux virtual machines, with templates, snippets, and an MCP server.

> This is the Markdown version of the WSL Manager page on OpenNavo, with the same facts as the web page: <https://opennavo.com/apps/wsl-manager>

- **Latest version**: `2.6.1`
- **Developer**: Bostrot
- **Homepage**: <https://wslmanager.com/>
- **Categories**: [Virtualization & Containers](https://opennavo.com/categories/virtualization)
- **Install**: `brew install --cask wsl-manager`
- **30-day installs**: 10
- **Homebrew**: Available; the app updates itself
- **Download URL**: <https://github.com/bostrot/wsl2-distro-manager/releases/download/v2.6.1/wsl2-distro-manager-v2.6.1-macos.dmg>
- **SHA-256**: `ba05c281cb5887e9a3c2e1f740c96e79175c5dda017584f707e016e0f2dfe2a7`

SHA-256 only checks that the download is complete; it is not a security certification.

## Installation and removal contents

```json
[
  {
    "declaration": {
      "uninstall": [
        {
          "quit": "com.bostrot.wsl2distromanager"
        }
      ]
    },
    "phase": "uninstall",
    "sources": [],
    "type": "uninstall"
  },
  {
    "declaration": {
      "app": [
        "WSL Manager.app"
      ],
      "target": "/Applications/WSL Manager.app"
    },
    "phase": "install",
    "sources": [
      "WSL Manager.app"
    ],
    "target": "/Applications/WSL Manager.app",
    "type": "app"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "~/Library/Application Support/WSLManager",
            "~/Library/Preferences/com.bostrot.wsl2distromanager.plist",
            "~/Library/Saved Application State/com.bostrot.wsl2distromanager.savedState"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## About

WSL Manager for macOS manages native Linux virtual machines rather than Windows Subsystem for Linux distributions. It provides a graphical interface for working with Linux machines on a Mac.

- Manage native Linux virtual machines on macOS.
- Save a configured instance as a template and create copies from it; keep command snippets in the app to run against instances.
- The app includes an MCP server. The product describes its MCP server as connecting the app’s instances to MCP clients, and says the macOS edition shares this server with the Windows edition.
- The macOS edition also shares the app’s interface, snippets, templates, and AI assistant with the Windows edition, but its managed machines are native VMs rather than WSL distros.

Install with `brew install --cask wsl-manager`. The Homebrew cask targets Apple Silicon Macs. The product site says macOS guest VMs require Apple Silicon. Windows-specific WSL features described on the product site, such as managing remote WSL distros, apply to the Windows variant, not this macOS native-VM variant.

Sources: [WSL Manager](https://wslmanager.com/) · [Homebrew cask](https://raw.githubusercontent.com/Homebrew/homebrew-cask/HEAD/Casks/w/wsl-manager.rb)

## System requirements

- macOS 12 or later · Version: 2.6.1 · Apple silicon · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/w/wsl-manager.rb> · Checked 2026-11-22
  - <https://github.com/bostrot/wsl2-distro-manager/releases/download/v2.6.1/wsl2-distro-manager-v2.6.1-macos.dmg>
  - SHA-256: `ba05c281cb5887e9a3c2e1f740c96e79175c5dda017584f707e016e0f2dfe2a7`

## WSL Manager security facts

Only facts that can be checked, each with its source and date. This is not a safety certification. To check the files you downloaded, scan them on your Mac with OpenNavo.

- <https://github.com/bostrot/wslmanager> · Open source: Yes — <https://github.com/bostrot/wslmanager> · Checked 2026-11-13

## Uninstall

- `brew uninstall --cask wsl-manager`

A regular uninstall removes the app and keeps its settings and caches.

### Deep clean (optional)

- `brew uninstall --zap --cask wsl-manager`

`--zap` also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out `--zap`.

A regular uninstall removes the app and keeps its settings and caches.

- Files and folders: `~/Library/Application Support/WSLManager` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/w/wsl-manager.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Preferences/com.bostrot.wsl2distromanager.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/w/wsl-manager.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Saved Application State/com.bostrot.wsl2distromanager.savedState` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/w/wsl-manager.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.

## Latest release notes

### 2.6.1 (2026-11-19)

> **New here?** The [2.0.0 release notes](https://github.com/bostrot/wslmanager/releases/tag/v2.0.0) carry the full picture — what WSL Manager 2 is, every feature, the download table and how Pro works. This release lists what changed since 2.5.0.

#### Containers

- **Create a container** (new): pick an image, then optionally a name, published ports, volumes, environment variables and a command — every field is one option of your engine's own run command.
- **WSL's own container engine** (new): on Windows with WSL 2.9.3 or later, containers from the built-in `wslc` engine show up next to Docker and Podman. Run `wsl --update` to get it. The AI assistant and the MCP server can drive it too.

#### AI assistant

- A redesigned chat panel: the input, Send and header buttons share one size, the input grows as you type, Send turns into Stop while the assistant works, and tool calls, tasks and messages are easier to read.
- One chat now records into one snippet. Every follow-up is added to the same snippet instead of creating a new one for each answer.
- **AI Workspace:** a new setting stops the `ai-workspace` distro from being set up automatically, so deleting it stays deleted. The AI Workspace page offers to set it up again.

#### macOS

- **Fixes Linux VM disk corruption under heavy writes.** Linux disks are now attached with full sync, one disk can never be opened by two VMs at once, a VM gets a fair chance to shut down before it is forced off, and restart waits until the disk is released.
- **View console log** (new): every VM's serial console is saved to a log, so a guest stuck at boot (fsck, emergency mode) can be seen from the VM row.
- A VM's IP address is only reported when the lease really belongs to it and the guest answers. Before, a stale address could stick around.
- Requires macOS 12 or later.

#### And

- Text from `wsl.exe` on a non-English Windows is no longer garbled (#322).
- A failed disk resize or sparse change now shows as an error.
- Smaller fixes and maintenance.

#### Downloads
Same as 2.0.0: Microsoft Store (recommended on Windows), the `-setup.exe` or portable `.zip` below, `winget install Bostrot.WSLManager`, and on Apple silicon the `.dmg` or `brew install --cask wsl-manager`. On Windows on ARM, pick the `arm64` installer or ZIP.

**Full Changelog**: https://github.com/bostrot/wslmanager/compare/v2.6.0...v2.6.1

## Facts and sources

- <https://opennavo.com/apps/wsl-manager>
- <https://opennavo.com/apps/wsl-manager/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/w/wsl-manager.rb> · Checked 2026-11-22
- <https://formulae.brew.sh/cask/wsl-manager>
- <https://github.com/bostrot/wslmanager> · Checked 2026-11-13
