Skip to content

Commit 2133378

Browse files
committed
docs(user-guide): use brew install rustup instead of rustup-init
1 parent d68f145 commit 2133378

File tree

1 file changed

+21
-7
lines changed

1 file changed

+21
-7
lines changed

doc/user-guide/src/installation/other.md

Lines changed: 21 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -38,6 +38,21 @@ $ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- --profile
3838
> If you have encountered any problems installing `rustup` with a package manager,
3939
> please contact the package maintainer(s) for further information.
4040
41+
In general, installing rustup with your package manager means installing a rustup binary to
42+
somewhere accessible via your `$PATH`.
43+
To complete installing Rust, you will need to find out the name of that binary:
44+
45+
- If the binary is named `rustup`, picking a default toolchain would usually be enough.
46+
A popular choice is to set the default toolchain to `stable`:
47+
48+
```sh
49+
rustup default stable
50+
```
51+
52+
- If the binary is named `rustup-init`, simply execute `rustup-init` and follow the instructions.
53+
When the installation is complete, make sure that `$HOME/.cargo/bin` is in your `$PATH`,
54+
and you should be able to use `rustup` normally.
55+
4156
### APT
4257

4358
Starting from Debian 13 (trixie) and Ubuntu 24.04 (noble),
@@ -49,17 +64,16 @@ $ sudo apt install rustup
4964

5065
### Homebrew
5166

52-
You can use `brew` to install `rustup-init`[^not-rust]:
67+
You can use `brew` to install `rustup`[^not-rust]:
5368

5469
```sh
55-
$ brew install rustup-init
70+
$ brew install rustup
5671
```
5772

58-
Then execute `rustup-init` to proceed with the installation.
59-
60-
When the installation is complete,
61-
make sure that `$HOME/.cargo/bin` is in your `$PATH`,
62-
and you should be able to use `rustup` normally.
73+
Please note that Rust tools like `rustc` and `cargo` are not available via `$PATH` by default
74+
in this `rustup` distribution
75+
(see [homebrew-core#177582](https://github.com/Homebrew/homebrew-core/pull/177582) for more details).
76+
You might want to add `$(brew --prefix rustup)/bin` to `$PATH` to make them easier to access.
6377

6478
[^not-rust]: This is not to be confused with the `rust` package,
6579
which is a `brew`-managed `rust` toolchain installation.

0 commit comments

Comments
 (0)