How to choose not to install certain components in `rustup toolchain install`

[stackinspector]

I use internet to read docs and I don't want to include docs in every toolchain.

[vague]

For local toolchain

rustup toolchain install nightly --profile minimal

• The minimal profile includes as few components as possible to get a working compiler (rustc, rust-std, and cargo). 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.

For changing the current toolchain

rustup set profile minimal

For project toolchain

# rust-toolchain.toml
[toolchain]
channel = "version"
components = [ "rustfmt" ]
profile = "minimal"

For the first time installing Rust

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 .

https://rust-lang.github.io/rustup/concepts/profiles.html

[stackinspector]

How do I "apply" profile changes (remove components that no need) to my current installation?

[vague]

rustup component remove xxx

$ rustup component --help
rustup-component
Modify a toolchain's installed components

USAGE:
    rustup component <SUBCOMMAND>

FLAGS:
    -h, --help    Prints help information

SUBCOMMANDS:
    list      List installed and available components
    add       Add a component to a Rust toolchain
    remove    Remove a component from a Rust toolchain
    help      Prints this message or the help of the given subcommand(s)

[stackinspector]

Can I only manually remove components one by one?

[vague]

You can also do

rustup set profile minimal
rustup component add xxx