rustup

Install Rust toolchain

$ rustup install [stable]

$ rustup default [stable]

$ rustup update

$ rustup show

$ rustup component add [rustfmt]

$ rustup target add [x86_64-unknown-linux-musl]

$ rustup run [nightly] [cargo build]

$ rustup override set [nightly]

$ rustup install nightly

$ rustup uninstall [nightly]

rustup [options] command [args]

rustup is the Rust toolchain installer and version manager. It installs and manages multiple Rust versions (stable, beta, nightly), components (rustfmt, clippy), and cross-compilation targets.
Toolchains are installed per-user in ~/.rustup. Rustup manages the active toolchain, allowing easy switching between versions globally or per-project using rust-toolchain.toml files.
rustup also handles updating Rust, ensuring all installed toolchains stay current with a single command.

install toolchain

Install a toolchain.

Remove a toolchain.

Update installed toolchains.

Set default toolchain.

Show installed toolchains.

Run command with specific toolchain.

Set directory-specific override.

Remove directory override.

Add component to toolchain.

List available components.

Add compilation target.

List available targets.

Update rustup itself.

Open Rust documentation.

~/.rustup/

Root directory for all rustup data including installed toolchains, components, and metadata.

Per-project file specifying the required Rust toolchain version, components, and targets. Rustup automatically installs the specified toolchain when entering the directory.

Environment variable overriding the default rustup installation directory.

Environment variable overriding the active toolchain for the current session.

Nightly may have breaking changes or bugs. Some components not available for all toolchains. Cross-compilation targets may need additional linkers. Disk space usage grows with multiple toolchains.

rustup was developed by Brian Anderson and the Rust team, released in 2016 as the official Rust installer, replacing multirust. It unified Rust installation across platforms and simplified version management. Rustup became the recommended way to install Rust, replacing distribution packages for most developers.

rustc(1), cargo(1), rustfmt(1), clippy(1)