Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

rustup

rustup.rs

  • Free plan
  • Windows
  • macOS
  • Linux
7.9 Club score Visit rustup.rs

What rustup is

rustup installs Rust from its official release channels and manages the toolchains and components developers use. It can switch among stable, beta, and nightly compilers, keep them updated, and install particular versions or dated releases. For cross-compilation, rustup adds a target platform’s standard library; Android builds also require the Android NDK and usually a linker. It manages official and archived toolchains, alternate hosts, and local builds, and provides command proxies for tools including rustc, Cargo, rustdoc, rust-analyzer, Clippy, and Miri. Components available for installation vary by release and toolchain, especially on nightly. rustup runs on Linux, macOS, and Windows, as well as several other listed operating systems. Unix installation uses a shell script, while Windows installation uses rustup-init.exe; Windows users may also need Visual Studio prerequisites. Downloads use HTTPS, but signatures are not yet validated. rustup is free and open source, with a license under Apache 2.0 or MIT.

Who it suits

rustup suits Rust developers who need to install and switch toolchains, manage components, or build for other targets. It can also manage locally built toolchains.

Good to know, and what to watch

  • Switch among stable, beta, and nightly toolchains.
  • Install specific Rust versions or dated releases.
  • Add target standard libraries for cross-compilation.
  • Generate shell completions for Bash, Fish, Zsh, and PowerShell.
  • Nightly toolchains may lack components or fail to build.
  • Download signatures are not yet validated.
  • Android cross-compilation also requires the NDK and usually a linker.

rustup

Free

Open source

Getting started

  1. Open the rustup website
  2. Run the shell-script installer on Unix systems
  3. Run rustup-init.exe on Windows
  4. Choose a minimal, default, or complete install profile
  5. Select or install the Rust toolchain and components you need
  6. Add cross-compilation targets with `rustup target add`

Limits to check

Component availability varies between releases and toolchains, with nightly builds especially prone to missing components or build failures. The complete install profile is documented as almost always failing.

The Club's review

Overview

rustup is the official Rust project’s toolchain manager, built for people who need to install Rust and control which compiler their work uses. It is best suited to Rust developers working across projects, release channels, or target platforms; its deep version control is useful, but nightly builds and unsigned downloads call for care.

Key features

Stable, beta, and nightly channels let developers separate dependable day-to-day work from testing upcoming Rust changes. rustup can update toolchains or install a particular version or dated release, while automatic switching and project version pinning help keep separate projects on the compiler they require. That is more practical than relying on a single machine-wide Rust version.

For cross-compilation, rustup target add installs a target’s standard library. This is a useful piece of target setup, not a guarantee that the whole build environment is ready: Android builds also require the Android NDK and usually a linker. rustup can manage official channels, archived releases, alternate hosts, and local toolchain builds in one place, which gives developers flexibility without limiting them to standard releases.

Tool proxies expose utilities such as rustc, rustdoc, cargo, rust-analyzer, Clippy, and Miri. Components also include rustfmt, rust-std, rust-docs, and rust-src. Minimal, default, and complete profiles group components for installation, but the complete profile will almost always fail. Component availability varies by release and toolchain; nightly is particularly unpredictable, with components sometimes missing when a build is broken.

Shell completion generation supports Bash, Fish, Zsh, and PowerShell. The rust-analyzer proxy can provide language-server support for editors including Visual Studio Code, Vim, and Emacs. Installation uses a shell script on Unix and rustup-init.exe on Windows; Windows users may also need Visual Studio prerequisites. rustup downloads over HTTPS, but does not validate download signatures. SHA-256 checksums are available for listed manual installer downloads, an option for users who want to verify those files.

Pricing

rustup is free and open source, with a listed price of free. There is no paid tier or trial to weigh against it, so its price suits individual developers and teams alike. The project is licensed under either Apache License 2.0 or MIT. A trade-off is that installation through APT, Homebrew, pacman, or DNF depends on packages rustup does not maintain.

Platforms

The installer supports Windows, Linux, macOS, FreeBSD, NetBSD, Solaris, and illumos. Unix users install through a shell script; Windows users use rustup-init.exe and may need Visual Studio prerequisites. The listed supported platforms are Linux, macOS, and Windows, while the installer also runs on the BSD and Unix-family systems above.

Who it's for

rustup is the right choice for Rust developers who want official release channels, project-level version control, or standard-library targets managed through one tool. It is also useful to developers maintaining local builds alongside published toolchains. It is less suitable for anyone who needs predictable nightly component coverage or requires download signatures to be checked automatically. For Android work, expect to install the NDK and usually a linker separately.

Pros and cons

Pros

  • Stable, beta, nightly, dated, archived, alternate-host, and local toolchains offer substantial control over Rust versions and builds.
  • Automatic switching, project pinning, and updates help keep each project on its intended compiler.
  • Target installation and proxies for common Rust tools cover key development workflows without a separate manager for each tool.
  • Free, open-source use and broad installer support make it accessible across common desktop systems and several additional Unix-like platforms.

Cons

  • Nightly toolchains can be broken or lack components for a given date and target, which makes them a poor choice when reproducibility depends on guaranteed availability.
  • HTTPS downloads are not signature-validated by rustup, so security-conscious users may need to verify manual installer checksums themselves.
  • The complete installation profile will almost always fail, so users should not treat it as a reliable way to install every component.
  • Cross-compiling is not always a one-command setup: Android also needs the NDK and usually a linker.

Alternatives

For a directory of other runtime managers, see Runtime Version Managers. If you want a free manager for Go, GVM or goenv are alternatives; both are free, and goenv is MIT-licensed. For Node.js, choose nvm if you want its free, open-source version manager, or consider fnm or nodenv, both free options; nodenv is for Unix-like systems. elan is a free option for Lean version management. PHPBrew is a free PHP version manager, but building PHP requires development packages and unsupported older PHP versions may fail. asdf is a free, open-source tool version manager for readers who want version management beyond Rust.

Verdict

Choose rustup if Rust is part of your work and you need reliable control over toolchains, project versions, and compilation targets without paying for a manager. Its main advantage is bringing official Rust releases and local builds under one workflow; look elsewhere if you need signature validation or cannot accommodate nightly’s variable build and component availability.

The verdict

rustup brings Rust toolchain installation, updates, switching, and target management together in a free tool. Check component availability for your chosen toolchain, particularly if you use nightly.

Questions people ask

How much does rustup cost?

rustup is free and open source. The listed plan is free, with no paid plans stated.

Which operating systems can run rustup?

The installer runs on Windows, Linux, macOS, FreeBSD, NetBSD, Solaris, and illumos.

Can rustup manage several Rust versions?

Yes. It manages stable, beta, nightly, archived, alternate-host, dated, and local toolchains, and can switch between them.

Does rustup support cross-compilation?

Yes. Install a target platform’s standard library with `rustup target add`. Android targets additionally require the Android NDK and usually a linker.

Which tools and components can it install?

Proxies include rustc, rustdoc, cargo, rust-analyzer, Clippy, and Miri. Components include rustfmt, rust-std, rust-docs, rust-analyzer, clippy, miri, and rust-src, subject to release availability.

What the maker publishes

Android target
rustup can install an Android target, but cross-compiling to Android also requires the Android NDK and usually a linker. source
Component availability
Available components vary across releases and toolchains, and some may be absent when nightly builds are broken. source
Component limitation
Component availability varies between releases and toolchains, especially on nightly. source
Components
Toolchain components include rustc, cargo, rustfmt, rust-std, rust-docs, rust-analyzer, clippy, miri and rust-src. source
Cross-compilation
rustup provides binary standard-library releases for many platforms and installs targets with `rustup target add`. source
Cross-compiling
It supports cross-compiling by installing the target platform's standard library with the rustup target command. source
Custom toolchains
Developers can link rustup to local Rust toolchain builds and manage them like other toolchains. source
IDE integrations
The rust-analyzer proxy provides language-server support for editors including Visual Studio Code, Vim, and Emacs. source
Installation
Unix installation uses a shell script, while Windows installation uses rustup-init.exe. source
Install profiles
The minimal, default, and complete profiles group components for toolchain installation, though the documentation says complete will almost always fail. source
Integrity information
The installation documentation says SHA-256 checksums are available for the listed manual installer downloads. source
License
The rustup repository is licensed under either Apache License 2.0 or the MIT license. source
Nightly availability
Nightly toolchains may fail to build or may be missing non-default components for a given date and target. source
Package managers
Official documentation describes installation through APT, Homebrew, pacman and DNF, while noting rustup does not maintain those packages. source
Project status
The rustup site identifies rustup as an official Rust project. source
Purpose
rustup installs the Rust programming language from official release channels. source
Security
rustup downloads over HTTPS but does not yet validate download signatures. source
Shell integration
rustup can generate completion scripts for Bash, Fish, Zsh and PowerShell. source
Support
The rustup site directs users to the Rust community for help, and the rustup book points to the GitHub issue tracker for problems. source
Supported hosts
The installer runs on Windows, Linux, macOS, FreeBSD, NetBSD, Solaris and illumos. source
Supported operating systems
The installer says rustup runs on Windows, Linux, macOS, FreeBSD, NetBSD, Solaris, and illumos. source
Toolchain management
rustup manages multiple toolchains, including official channels, archived releases, alternate hosts and local builds. source
Toolchain switching
rustup lets users switch between stable, beta and nightly Rust compilers and keep them updated. source
Toolchain switching
It supports stable, beta, and nightly toolchains and can switch the active toolchain through a shared set of command proxies. source

Checked against the maker's pages on 2 Oct 2026.