Installation
Install the MildStack CLI and Desktop App on macOS, Windows, or Linux.
Install the CLI
The MildStack CLI is a single native binary — no Docker, no containers, no runtime dependencies.
macOS
Download the latest release from GitHub Releases:
# Apple Silicon (M1/M2/M3/M4)
curl -L https://github.com/michasdev/mildstack/releases/latest/download/mildstack-darwin-arm64 -o mildstack
chmod +x mildstack
sudo mv mildstack /usr/local/bin/
# Intel
curl -L https://github.com/michasdev/mildstack/releases/latest/download/mildstack-darwin-amd64 -o mildstack
chmod +x mildstack
sudo mv mildstack /usr/local/bin/Linux
# x86_64
curl -L https://github.com/michasdev/mildstack/releases/latest/download/mildstack-linux-amd64 -o mildstack
chmod +x mildstack
sudo mv mildstack /usr/local/bin/
# ARM64
curl -L https://github.com/michasdev/mildstack/releases/latest/download/mildstack-linux-arm64 -o mildstack
chmod +x mildstack
sudo mv mildstack /usr/local/bin/Windows
Download mildstack-windows-amd64.exe from GitHub Releases and add it to your PATH.
Verify Installation
mildstack --helpYou should see:
mildstack is the shared binary entrypoint for the MildStack core runtime.
Usage:
mildstack [command]
Available Commands:
start Start the shared HTTP runtime
instances List known instances
status Show instance status
stop Stop a running instance
delete Delete an instanceInstall the Desktop App
The MildStack Desktop App is an Electron-based visual console that lets you browse and manage your local AWS resources.
Download
Download the latest installer for your platform from GitHub Releases:
| Platform | File |
|---|---|
| macOS (Apple Silicon) | MildStack-*-arm64.dmg |
| macOS (Intel) | MildStack-*-x64.dmg |
| Windows (x64) | MildStack-*-x64-setup.exe |
| Windows (ARM) | MildStack-*-arm64-setup.exe |
| Linux (x64) | MildStack-*-amd64.AppImage |
CLI included
The Desktop App bundles the MildStack CLI binary and can install it to your system path automatically on first launch.
Build from Source
If you prefer to build MildStack yourself:
Prerequisites
- Go 1.26.2 or later
- Node.js 20+ and npm (for Desktop App)
- Git
Build the CLI
git clone https://github.com/michasdev/mildstack.git
cd mildstack
go build -o mildstack ./core/cmd/mildstackBuild the Desktop App
cd apps/desktop
npm install
npm run buildSystem Requirements
| Component | Minimum | Recommended |
|---|---|---|
| RAM | 50 MB | 128 MB |
| Disk | 20 MB (binary) | 100 MB (with data) |
| OS | macOS 12+, Windows 10+, Ubuntu 20.04+ | Latest stable |

