Shimpz
Installation guide

Install on Windows

Supported · WSL2 x64

Shimpz runs in Ubuntu on WSL2, not directly in Windows. PowerShell installs and checks WSL; every Shimpz and Docker command runs inside the Ubuntu terminal.

  1. Check your computer

    Use Windows on an x64-based processor. Windows 11 is recommended; Windows 10 must meet the current Microsoft WSL requirements and Docker Desktop requirements.

  2. Install WSL2 and Ubuntu

    Open PowerShell as Administrator and run:

    PowerShell · Administrator
    wsl --install -d Ubuntu

    Restart Windows if asked, open Ubuntu from the Start menu, and create your Linux username and password.

    Back in PowerShell, confirm that Ubuntu uses WSL version 2:

    PowerShell · WSL check
    wsl --list --verbose

    If Ubuntu shows version 1, convert it before continuing:

    PowerShell · WSL upgrade
    wsl --set-version Ubuntu 2

  3. Connect Docker Desktop to Ubuntu

    Install Docker Desktop for Windows and start it. In Docker Desktop, enable Use the WSL 2 based engine, then open Settings → Resources → WSL Integration, enable Ubuntu, and apply the change.

    Do not install a second Docker Engine inside Ubuntu; use the Docker Desktop WSL integration. The detailed flow is documented in Docker's WSL2 backend guide.

  4. Check Ubuntu and Docker

    Open the Ubuntu terminal. First confirm that WSL reports the supported x64 architecture:

    Ubuntu · Processor check
    uname -m
    x86_64

    Continue only when the result is x86_64, then check the Docker integration:

    Ubuntu · Docker check
    docker version
    docker compose version

  5. Install Shimpz inside Ubuntu

    Keep using the Ubuntu terminal and run:

    Ubuntu · Shimpz install
    curl -fsSL https://install.shimpz.com | sh

  6. Open the Admin from Windows

    After the installer reports success, open this address in your Windows browser:

    Browser · local Admin
    http://127.0.0.1:7777