Quick Start with Windows
Prerequisites1. Install the Meshery command line client, mesheryctl .
To set up and run Meshery on Windows
The following minimum Windows build versions are required:
|WSL1||x64 - Windows 7|
|WSL2||x64 - Version 1903, Build 18362; ARM 64 - Version 2004, Build 19041|
|Custom Kernel||Build 18945|
|Kernel with K8s required modules||Build 19013|
Run the following command on Powershell to check your Windows build and version:
Perform the following steps in order:
Open Powershell in administrator mode and run:
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart Restart-Computer
Choosing your WSL version:
Set the default version to WSL2, which will be inherited by any distro you wish to use.
Enable VM (Virtual Machine) feature:
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
Set WSL2 as the default version:
wsl --set-default-version 2
If you still wish to continue, follow the instructions for
In this tutorial, Ubuntu 18.04 will be the distro used. Feel free to use any distro of your choice.
3. Enable Docker
The Docker Desktop application for Windows includes a comprehensive set of tools, including Docker Engine, Docker CLI client, Docker Compose, Notary, Kubernetes, and a Credential Helper.
|Windows 10 Version||Docker Desktop|
|Pro/Education/Enterprise||Docker Desktop for Windows Pro|
|Home||Docker Desktop for Windows Home|
Once Docker is installed, the next step will be to install a Kubernetes cluster. In this how-to, K3d will be used as it relies only on Docker.
curl -s https://raw.githubusercontent.com/rancher/k3d/main/install.sh | bash k3d cluster create export KUBECONFIG="$(k3d kubeconfig get 'k3s-default')"
Follow the installation steps to install the mesheryctl CLI. Then, execute:
./mesheryctl system start