Install merido

The fastest way to get merido is the prebuilt binary. It's a single static executable that self-hosts the gateway, the dashboard, and the marketing site from one port — no Rust toolchain required. Prebuilt releases are published for macOS (arm64 + x86_64), Linux (x86_64 + arm64), and Windows (x86_64).

Prefer to build it yourself? Building from source still works — see the Quick start.

macOS & Linux

curl -fsSL https://merido.dev/install.sh | sh

This downloads the right archive for your OS and CPU, unpacks the merido binary, and installs it to a directory on your PATH.

Environment overrides

The installer reads a few environment variables so you can pin a version, change the install location, or install from a self-hosted mirror:

Variable	Default	What it does
MERIDO_BASE_URL	https://merido.dev	Host to download the installer manifest and binaries from. Point it at your own mirror.
MERIDO_VERSION	latest	Pin a specific release tag (e.g. v0.1.0) instead of the latest.
MERIDO_BIN_DIR	a directory on your PATH	Where to install the merido binary.

For example, to install a specific version into ~/.local/bin:

curl -fsSL https://merido.dev/install.sh | \
  MERIDO_VERSION=v0.1.0 MERIDO_BIN_DIR="$HOME/.local/bin" sh

Windows (PowerShell)

Run this in a PowerShell prompt:

irm https://merido.dev/install.ps1 | iex

It downloads the latest x86_64 build and places merido.exe on your PATH.

Manual download

Every release is a self-contained archive. Browse the manifest at https://merido.dev/dl/latest.json, then download the asset for your platform from https://merido.dev/dl/<asset>:

Platform	Asset
macOS · Apple Silicon	merido-aarch64-apple-darwin.tar.gz
macOS · Intel	merido-x86_64-apple-darwin.tar.gz
Linux · x86_64	merido-x86_64-unknown-linux-gnu.tar.gz
Linux · arm64	merido-aarch64-unknown-linux-gnu.tar.gz
Windows · x86_64	merido-x86_64-pc-windows-msvc.zip

Unpack the archive and move the merido binary (or merido.exe) somewhere on your PATH.

Keep merido up to date

merido self-updates from the same host you installed it from — no package manager, no reinstall:

# download & install the latest release
merido update

# just check whether a newer version is available
merido update --check

Run it

# start the gateway (embedded SQLite under ~/.merido) on http://127.0.0.1:8788
merido start

# or launch the interactive menu
merido

Next steps

• Quick start — create a gateway key, add a provider, and make your first request (also covers building from source).
• Connect a coding CLI — wire Claude Code / Codex / Cursor to merido.