Installation

Using install scripts

Linux, macOS

Terminal window
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/probe-rs/probe-rs/releases/latest/download/probe-rs-tools-installer.sh | sh

Windows

Terminal window
irm https://github.com/probe-rs/probe-rs/releases/latest/download/probe-rs-tools-installer.ps1 | iex

From package managers

homebrew

Terminal window
brew tap probe-rs/probe-rs
brew install probe-rs

cargo binstall

Terminal window
cargo binstall probe-rs-tools

Installing from source (cargo install)

Prerequisites

To build probe-rs from source, you will need a working Rust toolchain. The easiest way is to follow the rustup installation instructions.

Debian-based Linux

On Debian and derived distros (e.g. Ubuntu), the following packages need to be installed:

Terminal window
sudo apt install -y pkg-config libudev-dev cmake git

RPM-based Linux (Fedora, CentOS)

Terminal window
dnf install libusbx-devel libudev-devel cmake git

macOS

No additional setup is required.

Windows

No additional setup is required.

Installation

cargo install will download, compile and install probe-rs, cargo-flash and cargo-embed for you.

You have multiple options, the two most interesting are:

  • To install the latest release, run cargo install probe-rs-tools --locked
  • To try the latest development version (a.k.a the master branch) with experimental and unreleased changes, run cargo install probe-rs-tools --git https://github.com/probe-rs/probe-rs --locked

See the Cargo book for details.

Uninstalling

How you remove probe-rs depends on how you installed it.

Install scripts

The install scripts don’t ship an uninstaller, so the binaries have to be removed by hand. They are placed in Cargo’s binary directory (~/.cargo/bin, or %USERPROFILE%\.cargo\bin on Windows):

Terminal window
rm ~/.cargo/bin/probe-rs ~/.cargo/bin/cargo-flash ~/.cargo/bin/cargo-embed

The installer also drops an install receipt that you can remove:

Terminal window
rm -r ~/.config/probe-rs-tools

If you installed shell completions with probe-rs complete install, delete the completion file it created for your shell. If you allowed the installer to modify your PATH, remove the line it added to your shell profile.

homebrew

Terminal window
brew uninstall probe-rs
brew untap probe-rs/probe-rs

cargo (cargo install / cargo binstall)

Terminal window
cargo uninstall probe-rs-tools

Shell completion

You likely want to install shell completion support along with the probe-rs binaries. Just run:

Terminal window
probe-rs complete install

If your shell is not supported out of the box, please follow the instructions given by this command.