installation · macOS · Linux · Windows · Docker

Install betterMQ

One binary, no external dependencies. Pick your platform — every path ends with a running broker, control panel and docs on port 8080.

01

macOS · Linux · WSL

One-line install

Detects your OS and architecture, downloads the right binary from GitHub Releases, verifies the sha256 checksum and links it into your PATH.

  • Apple Silicon and Intel Macs both supported
  • WSL installs the native Linux binary
  • Re-run any time to update — same version is skipped
terminal
$ curl -fsSL https://bettermq.com/install | bash
02

Windows

PowerShell install

Same flow for Windows — downloads bettermq.exe, verifies the checksum and adds it to your user PATH. No admin rights required.

  • Works in Windows Terminal, PowerShell 5+ and pwsh
  • Open a new terminal after install to pick up PATH
powershell
> powershell -ExecutionPolicy Bypass -c "irm https://bettermq.com/install.ps1 | iex"
03

Docker

Docker Compose

Prefer containers? The selfhost stack brings up the broker with persistent storage in one command.

  • Panel, API and docs on port 8080
  • Optional Slate + MinIO and multi-node setup in selfhost/README.md
terminal
$ git clone https://github.com/betterMQ/betterMQ.git$ cd betterMQ/selfhost$ docker compose up -d --build

Under the hood

What the installer does

  1. 1Detects OS and CPU architecture
  2. 2Resolves the latest release from GitHub
  3. 3Downloads the matching binary
  4. 4Verifies the sha256 checksum
  5. 5Installs to ~/.bettermq/bin and links into PATH

The scripts are plain text — read them before running: /install · /install.ps1

Manual download

Release binaries

AssetPlatform
bettermq-macos-arm64.zipmacOS (Apple Silicon)
bettermq-macos-amd64.zipmacOS (Intel)
bettermq-linux-amd64.zipLinux (x86_64)
bettermq-windows-amd64.exe.zipWindows (x86_64)

Every release ships a checksums.txt — grab both from GitHub Releases.

First run

Start the broker

One process serves the API, the control panel and the interactive docs. Set a panel password on first visit, copy your sk_local_… token and send your first job.

  • Panel — http://localhost:8080/panel/
  • API docs — http://localhost:8080/docs
terminal
$ bettermq serve
or build from source
$ cargo build --release -p broker-server

Up and running?

Send your first durable job and explore scheduling, fan-out and flow control from the panel.

Explore featuresRead the docs