Install mpx

MACOS · LINUX · ARM64 & X86_64

mpx is the companion CLI for Multiplex. You run it on the machine you want to add — mpx bind offers the machine to the app with a QR code in the terminal and an announcement on the local network, and enrolls a public key when you confirm. Prebuilt for macOS and Linux; nothing to install on your Apple devices.

Homebrew macOS · Linux

brew install multiplex-term/tap/mpx

Installs mpx and the spelled-out multiplex alias from the multiplex-term/tap tap. Later, brew upgrade mpx updates it and brew uninstall mpx removes it.

One-line installer macOS · Linux

curl -fsSL https://multiplexterm.dev/install-mpx-cli | sh

For machines without Homebrew — a server is exactly where you usually run mpx bind. The script is plain POSIX sh (dash and busybox included), needs only curl and tar, and:

Verifies before installing. Every download is checked against the release’s published SHA256SUMS; a mismatch refuses to install.
Never asks for root. It installs into the first writable directory already on your PATH (~/.local/bin, /usr/local/bin, or ~/bin) and tells you if none qualifies — no sudo, ever.
Installs both names: mpx and the multiplex alias.

Adjust it with environment variables:

Variable	Effect
`MPX_VERSION=v0.1.1`	Install a specific tag instead of the latest release.
`MPX_INSTALL_DIR=~/bin`	Install here instead of the default search.
`MPX_NO_ALIAS=1`	Install only `mpx`, skip the `multiplex` alias.

curl -fsSL https://multiplexterm.dev/install-mpx-cli | MPX_INSTALL_DIR=~/bin sh

Prefer to read what you run? The installer lives at multiplexterm.dev/install-mpx-cli — open it first, then pipe it.

Manual download

Every release on multiplex-term/mpx-cli ships four archives. Linux builds are statically linked against musl, so one binary covers glibc distributions and Alpine alike.

Platform	Archive
macOS, Apple silicon	`mpx-<tag>-aarch64-apple-darwin.tar.gz`
macOS, Intel	`mpx-<tag>-x86_64-apple-darwin.tar.gz`
Linux, arm64	`mpx-<tag>-aarch64-unknown-linux-musl.tar.gz`
Linux, x86_64	`mpx-<tag>-x86_64-unknown-linux-musl.tar.gz`

Verify against the same release’s SHA256SUMS, then put mpx somewhere on your PATH:

shasum -a 256 -c SHA256SUMS --ignore-missing   # sha256sum on Linux
tar -xzf mpx-<tag>-<target>.tar.gz
install -m 755 mpx-<tag>-<target>/mpx ~/.local/bin/

Then bind the machine

On the machine you just installed to:

mpx bind

It prints a QR code right in the terminal and announces itself on the local network. Scan it with Multiplex, or approve it from Add Host ▸ BIND and type the PIN; the machine confirms on its own screen and lands on the wall. Add --copy to put the offer on the clipboard instead, or --addr to name the address the app should reach when the machine sits behind NAT.

Everything is reversible by name: the enrolled key is labeled in authorized_keys, so mpx unbind removes exactly what bind added — nothing else.

Problems?

Open an issue on the CLI’s repository, and include mpx --version and your platform.