Other installation methods - The rustup book (original) (raw)

The rustup book

Other installation methods

The primary installation method, as described at https://rustup.rs, differs by platform:

On Windows, download and run the rustup-init.exe built for thex86_64-pc-windows-msvc or aarch64-pc-windows-msvc target, depending on your OS architecture. In general, this is the build ofrustup one should install on Windows. This will require the Visual C++ Build Tools 2019 or equivalent (Visual Studio 2019, etc.) to already be installed. If you would prefer to install GNU toolchains or the i686 toolchains by default this can be modified at install time, either interactively, with the --default-host flag, or after installation via rustup set default-host.
On Unix, run curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh in your shell. This downloads and runs rustup-init.sh, which in turn downloads and runs the correct version of the rustup-init executable for your platform.

rustup-init accepts arguments, which can be passed through the shell script. Some examples:

$ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- --help
$ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- --no-modify-path
$ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- --default-toolchain nightly
$ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- --default-toolchain none
$ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- --profile minimal --default-toolchain nightly

Using a package manager

Please note that the rustup project is not maintaining any package mentioned in this section. If you have encountered any problems installing rustup with a package manager, please contact the package maintainer(s) for further information.

General tips

Different package managers take slightly different approaches towards managing rustup. After installing rustup with your favorite package manager, there are usually two possibilities:

If your package manager has made the rustup command available together with proxies for Rust tools such as rustc and cargo, picking a default toolchain (e.g. stable) would usually be enough:

$ rustup default stable

As of 2024/12/23, this is the case forAPT,homebrewand pacman.

If your package manager has only made the rustup-init command available, simply run:

$ rustup-init

This will allow you to perform the initial setup of rustup, populate all the proxies managed by rustup, and install a default toolchain.

As of 2024/12/23, this is the case forDNF.

When the installation is completed, please make sure that the rustup proxies (usually under $HOME/.cargo/bin) are correctly exposed via your $PATH, and you should be able to run rustup, rustc, cargo, etc. normally.

APT

Starting from Debian 13 (trixie) and Ubuntu 24.04 (noble), you may use apt to install rustup:

$ sudo apt install rustup

Homebrew

You can use brew to install rustup1:

$ brew install rustup

Please note that Rust tools like rustc and cargo are not available via $PATH by default in this rustup distribution (see homebrew-core#177582 for more details). You might want to add $(brew --prefix rustup)/bin to $PATH to make them easier to access.

Manual installation

You can manually download rustup-init for a given target fromhttps://static.rust-lang.org/rustup/dist/{target-triple}/rustup-init[.exe]2 3.

Direct links

To get a previous version, usehttps://static.rust-lang.org/rustup/archive/{rustup-version}/{target-triple}/rustup-init[.exe].

SHA-256 checksums are also available by appending .sha256 to the link.

Self-compiled installation

To install rustup from source, check out the git repository fromhttps://github.com/rust-lang/rustup and run cargo run --release. Note that after installation the rustup toolchains will supersede any pre-existing toolchains by prepending ~/.cargo/bin to the PATH environment variable.