Quick Start

Use the install script. It installs the standalone binary into ~/.miravo/bin.

curl -fsSL https://miravo.dev/install | bash

Install from your package manager. Requires Node.js.

npm install -g miravo

Or run without installing: npx miravo, pnpm dlx miravo, bunx miravo, yarn dlx miravo.

docker run --rm -p 1883:1883 -p 8080:8080 amineamaach/miravo:latest

Also available on GitHub Container Registry as ghcr.io/amine-amaach/miravo:latest. For Compose stacks, volumes, and health probes, see Docker deployment.

Download a pre-built archive from GitHub Releases and extract:

tar xzf miravo-<version>-linux-x64.tar.gz
chmod +x miravo
./miravo start

The install script uses linux-x64, linux-arm64, darwin-x64, and darwin-arm64 archives.

No Node.js or Docker required.

npm install -g miravo

docker run --rm -p 1883:1883 -p 8080:8080 amineamaach/miravo:latest

Windows standalone archives are not installed by the script. Use WSL for script installs, or use Docker, npm, or the Windows archive manually.

The install script supports Linux and macOS only.