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 the x86_64-pc-windows-msvc target. In general, this is the build of rustup 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.

Homebrew

You can use brew to install rustup-init1:

$ brew install rustup-init

Then execute rustup-init to proceed with the installation.

When the installation is complete, make sure that $HOME/.cargo/bin is in your $PATH, and you should be able to use rustup normally.

1

This is not to be confused with the rust package, which is a brew-managed rust toolchain installation.

Manual installation

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

Direct links

To get a previous version, use https://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.

2

Windows GNU builds require no additional software for basic use. However, many library crates will not be able to compile until the full MSYS2 with MinGW has been installed.

3

MSVC builds of rustup additionally require an installation of Visual Studio 2019 or the Visual C++ Build Tools 2019. For Visual Studio, make sure to check the “C++ tools” and “Windows 10 SDK” option.

Self-compiled installation

To install rustup from source, check out the git repository from https://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.