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.gz
Linux ARM64onmcu-aarch64-unknown-linux-gnu.tar.gz
macOS Apple silicononmcu-aarch64-apple-darwin.tar.gz
macOS Intelonmcu-x86_64-apple-darwin.tar.gz
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.

Check for updates

onmcu update

This checks the latest published release and prints the appropriate installer command when an update is available. The CLI also performs a cached background check during interactive use. See onmcu update for caching, CI behavior, and how to disable automatic notices.

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