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 (rls), 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 rustup profile you can use the rustup set profile command.
For example, to select the minimal profile you can use:
rustup set profile minimal
It's also possible to choose the 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.