Shimpz
Installation guide

Install on macOS

Apple Silicon

Use an M1 or newer Mac. Docker Desktop must be running before Shimpz starts.

  1. Protect the Mac with FileVault (recommended)

    In System Settings → Privacy & Security → FileVault, turn FileVault on and let encryption finish to protect Docker data if the Mac or its disk is stolen. FileVault is an operating-system setting: Shimpz does not turn it on or verify it, and installation is not blocked when it is off.

  2. Install Docker Desktop

    Install Docker Desktop for Mac with Docker Engine 25.0 or newer, runc 1.2.8+, 1.3.3+, or 1.4.0+ (shown by docker version), and Docker Compose 2.20.2 or newer, open it, and wait until Docker reports that it is running.

    Keep Docker Desktop's desktop-linux context selected. Shimpz uses that managed engine and stops safely if another context is active.

  3. Check Docker

    Open Terminal and run both commands:

    Terminal · Docker check
    docker version
    docker compose version

  4. Install Shimpz

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

  5. Confirm that Admin opens

    A successful shimpz install prints the exact local Admin address. Open that address; it is http://127.0.0.1:7777 when SHIMPZ_PORT was not changed. Continue when you see the initial password-and-authenticator setup or sign-in screen.