CheatPress

rustup Rust toolchain manager

Version 1.29 · source

rustup, Postcard, light preview Light · Postcard 102 × 152 mm · PDF rustup, Postcard, dark preview Dark · Postcard 102 × 152 mm · PDF rustup, Postcard, ink saver preview Ink saver · Postcard 102 × 152 mm · PDF
rustup, A5, light preview Light · A5 148 × 210 mm · PDF rustup, A5, dark preview Dark · A5 148 × 210 mm · PDF rustup, A5, ink saver preview Ink saver · A5 148 × 210 mm · PDF
rustup, A4, light preview Light · A4 210 × 297 mm · PDF rustup, A4, dark preview Dark · A4 210 × 297 mm · PDF rustup, A4, ink saver preview Ink saver · A4 210 × 297 mm · PDF
rustup, A4 landscape, light preview Light · A4 landscape 297 × 210 mm · PDF rustup, A4 landscape, dark preview Dark · A4 landscape 297 × 210 mm · PDF rustup, A4 landscape, ink saver preview Ink saver · A4 landscape 297 × 210 mm · PDF
rustup, A3, light preview Light · A3 297 × 420 mm · PDF rustup, A3, dark preview Dark · A3 297 × 420 mm · PDF rustup, A3, ink saver preview Ink saver · A3 297 × 420 mm · PDF
rustup, A3 landscape, light preview Light · A3 landscape 420 × 297 mm · PDF rustup, A3 landscape, dark preview Dark · A3 landscape 420 × 297 mm · PDF rustup, A3 landscape, ink saver preview Ink saver · A3 landscape 420 × 297 mm · PDF
rustup, Letter, light preview Light · Letter 8.5 × 11 in · PDF rustup, Letter, dark preview Dark · Letter 8.5 × 11 in · PDF rustup, Letter, ink saver preview Ink saver · Letter 8.5 × 11 in · PDF
rustup, Tabloid, light preview Light · Tabloid 11 × 17 in · PDF rustup, Tabloid, dark preview Dark · Tabloid 11 × 17 in · PDF rustup, Tabloid, ink saver preview Ink saver · Tabloid 11 × 17 in · PDF

Start here

rustup update
Update all toolchains
rustup toolchain install <toolchain>
Install a toolchain
rustup default <toolchain>
Set the global default
rustup show
What is active, and why?
rustup override set <toolchain>
Pin this directory
cargo +<toolchain> <cmd>
One-off toolchain
rustup component add <name>
Add clippy, rustfmt and more
rustup target add <target>
Cross-compile support

Concepts

  1. Channel stable / beta / nightly
  2. Toolchain channel + date + host
  3. Components clippy, rustfmt, ...
  4. Targets std per platform
Which toolchain wins (first match)
Source Example
1. +toolchain argument cargo +beta
2. env RUSTUP_TOOLCHAIN =beta
3. directory override override set 1.80
4. rust-toolchain.toml channel = ...
5. default default stable

Install & update

rustup update
Update installed toolchains and rustup
rustup update stable
Update only one toolchain
rustup check
Check for updates without installing
rustup self update
Update rustup itself only
rustup update --no-self-update
Skip the rustup self-update (CI)
rustup completions <shell>
Print shell completions
rustup self uninstall
Remove rustup and all toolchains
rustup man <command>
Open the man page of a tool

Toolchains

rustup toolchain install <toolchain>
Install a toolchain
Name form: <channel>[-<date>][-<host>], e.g. nightly-2026-01-15 or stable-msvc.
rustup toolchain list
List installed toolchains
rustup toolchain uninstall <toolchain>
Remove a toolchain
rustup toolchain install <toolchain> --profile minimal
Install without docs and extras
rustup toolchain install <toolchain> -c <component> -t <target>
Install with components and targets
rustup toolchain install 1.80
Install a specific version
rustup toolchain link <name> <path>
Register a local custom build
rustup set profile <profile>
Profile for future installs
minimal = rustc, rust-std, cargo; default adds rust-docs, rustfmt, clippy; complete is not recommended.
rustup toolchain install nightly --allow-downgrade
Newest nightly that has the components

Default & overrides

rustup default <toolchain>
Set the global default toolchain
rustup default
Print the current default
rustup override set <toolchain>
Pin a toolchain for this directory
rustup override unset
Remove this directory's override
rustup override list
List all directory overrides
rustup show
Active toolchain, installed ones, why
rustup show active-toolchain
Print only the active toolchain
rustup which <command>
Path of the binary that would run

Run with a toolchain

cargo +<toolchain> <command>
Run cargo with another toolchain once
Works for any proxy: rustc +nightly --version.
cargo +nightly fmt
Example: nightly-only rustfmt options
rustup run <toolchain> <command>
Run any command in a toolchain
rustup run <toolchain> $SHELL
Shell with that toolchain on PATH
RUSTUP_TOOLCHAIN=<toolchain> <command>
Pick a toolchain via environment

Components

rustup component list
Available and installed components
rustup component list --installed
Only installed components
rustup component add <component>
Add a component
rustup component add <component> --toolchain <toolchain>
Add to another toolchain
rustup component remove <component>
Remove a component
rustup component add rust-src
Std source for IDEs and build-std
rustup component add rust-analyzer
Language server for editors
rustup component add clippy rustfmt
Linter and formatter
rustup component add llvm-tools
LLVM tools (unstable, no guarantees)
rustup component add miri --toolchain nightly
Undefined-behavior interpreter
rustup doc --std
Open the offline std docs
Needs the rust-docs component (in the default profile).
rustup doc --book
Open the offline Rust book

Targets

rustup target list
All available targets
rustup target list --installed
Targets you have installed
rustup target add <target>
Install std for a target
rustup target add <target> --toolchain <toolchain>
Add to another toolchain
rustup target remove <target>
Remove a target
cargo build --target <target>
Build for that target
rustup target add wasm32-unknown-unknown
WebAssembly
rustup target add x86_64-unknown-linux-musl
Static Linux binaries

Pin a project

rust-toolchain.toml
[toolchain]channel = "1.80"components = ["rustfmt", "clippy"]targets = ["wasm32-unknown-unknown"]profile = "minimal"
RUSTUP_HOME / CARGO_HOME
Where toolchains and cargo/bin live
Set before installing to relocate; keep CARGO_HOME/bin on PATH.
RUSTUP_DIST_SERVER
Download from a mirror

Recipes

Try your crate on nightly
rustup toolchain install nightly --profile minimalcargo +nightly test# nothing global changed
Minimal CI toolchain
rustup toolchain install stable --profile minimal -c clippy -c rustfmt --no-self-updaterustup default stable
Cross-compile for musl
rustup target add x86_64-unknown-linux-muslcargo build --release --target x86_64-unknown-linux-muslls target/x86_64-unknown-linux-musl/release
Test against an old Rust
rustup toolchain install 1.75 --profile minimalcargo +1.75 check# or: rustup override set 1.75