rustup
rustup.rs
- Free plan
- Windows
- macOS
- Linux
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.
Plans
Every plan and pricerustup
Open source
Getting started
- Open the rustup website
- Run the shell-script installer on Unix systems
- Run rustup-init.exe on Windows
- Choose a minimal, default, or complete install profile
- Select or install the Rust toolchain and components you need
- 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.