MildStack Logo

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 --help

You 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 instance

Install 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:

PlatformFile
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/mildstack

Build the Desktop App

cd apps/desktop
npm install
npm run build

System Requirements

ComponentMinimumRecommended
RAM50 MB128 MB
Disk20 MB (binary)100 MB (with data)
OSmacOS 12+, Windows 10+, Ubuntu 20.04+Latest stable

Next Steps

On this page