Profiles
rustup has the concept of āprofilesā. They are groups of components you
can choose to download while installing a new Rust toolchain. The profiles
available at this time are minimal, default, and complete:
- The minimal profile includes as few components as possible to get a
working compiler (
rustc,rust-std, andcargo). Itās recommended to use this component on Windows systems if you donāt use local documentation (the large number of files can cause issues with some Antivirus systems), and in CI. - The default profile includes all of components in the minimal
profile, and adds
rust-docs,rustfmt, andclippy. This profile will be used byrustupby default, and itās the one recommended for general use. - The complete profile includes all the components available through
rustup. This should never be used, as it includes every component ever included in the metadata and thus will almost always fail. If you are looking for a way to install devtools such asmirior IDE integration tools (rust-analyzer), you should use thedefaultprofile and install the needed additional components manually, either by usingrustup component addor by using-cwhen installing the toolchain.
To change the profile rustup install uses by default, you can use the
rustup set profile command.
For example, to select the minimal profile you can use:
rustup set profile minimal
You can also directly select the profile used when installing a toolchain with:
rustup install --profile <name>
Itās also possible to choose the default profile when installing rustup for
the first time, either interactively by choosing the āCustomize installationā
option or programmatically by passing the --profile=<name> flag. Profiles
will only affect newly installed toolchains: as usual it will be possible to
install individual components later with: rustup component add.