Installation

Install the OnMCU CLI on Linux, macOS, or Windows.

Use the release installer on Linux, macOS, or Windows. You can also install through Cargo, use cargo-binstall, or download an archive.

curl --proto '=https' --tlsv1.2 -LsSf \
  https://github.com/onmcu/onmcu-rs/releases/latest/download/onmcu-installer.sh | sh

Run in PowerShell:

powershell -ExecutionPolicy Bypass -c "irm https://github.com/onmcu/onmcu-rs/releases/latest/download/onmcu-installer.ps1 | iex"

Install from crates.io with a Rust toolchain:

cargo install onmcu --locked

Install a pre-built release with cargo-binstall:

cargo binstall onmcu

Pre-built archives

Download your platform archive from the latest GitHub release.

PlatformArchive
Linux x86-64onmcu-x86_64-unknown-linux-gnu.tar.xz
Linux ARM64onmcu-aarch64-unknown-linux-gnu.tar.xz
macOS Apple silicononmcu-aarch64-apple-darwin.tar.xz
macOS Intelonmcu-x86_64-apple-darwin.tar.xz
Windows x86-64onmcu-x86_64-pc-windows-msvc.zip

Extract the archive and place the onmcu executable in a directory on your PATH.

Verify the installation

onmcu --version
onmcu --help

Continue with authentication, then list the boards available to your account.

Pin versions in automation

For reproducible CI, install a specific CLI release rather than resolving latest on every run. The OnMCU GitHub Action exposes this as its version input.

On this page