Skip to content

Commit eee44fd

Browse files
Merge pull request #1494 from rami3l/post/rustup-1-28-0
posts: announce rustup 1.28.0
2 parents 2f9eb15 + 2d20a97 commit eee44fd

File tree

1 file changed

+112
-0
lines changed

1 file changed

+112
-0
lines changed

posts/2025-03-02-Rustup-1.28.0.md

Lines changed: 112 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,112 @@
1+
---
2+
layout: post
3+
title: "Announcing Rustup 1.28.0"
4+
author: The Rustup Team
5+
---
6+
7+
The rustup team is happy to announce the release of rustup version 1.28.0.
8+
[Rustup][install] is the recommended tool to install [Rust][rust], a programming language that is empowering everyone to build reliable and efficient software.
9+
10+
## What's new in rustup 1.28.0
11+
12+
This new release of rustup has been a long time in the making and comes with substantial changes.
13+
14+
Before digging into the details, it is worth mentioning that [Chris Denton](https://github.com/chrisdenton) has joined the team.
15+
Chris has a lot of experience contributing to Windows-related parts of the Rust Project -- expertise we were previously lacking -- so we're happy to have him on board to help address Windows-specific issues.
16+
17+
The following improvements might require changes to how you use rustup:
18+
19+
- rustup will no longer automatically install the active toolchain if it is not installed.
20+
21+
- To ensure its installation, run `rustup toolchain install` with no arguments.
22+
- The following command installs the active toolchain both before and after this change:
23+
```sh
24+
rustup show active-toolchain || rustup toolchain install
25+
# Or, on older versions of PowerShell:
26+
rustup show active-toolchain; if ($LASTEXITCODE -ne 0) { rustup toolchain install }
27+
```
28+
29+
- Installing a host-incompatible toolchain via `rustup toolchain install` or `rustup default` will
30+
now be rejected unless you explicitly add the `--force-non-host` flag.
31+
32+
Rustup now officially supports the following host platforms:
33+
34+
- `aarch64-pc-windows-msvc`
35+
- `loongarch64-unknown-linux-musl`
36+
37+
This release also comes with various quality-of-life improvements, to name a few:
38+
39+
- `rustup show`'s output format has been cleaned up, making it easier to find out about your toolchains' status.
40+
- `rustup doc` now accepts a flag and a topic at the same time, enabling quick navigation to specific parts of more books.
41+
- rustup's `remove` subcommands now support more aliases such as `rm` and `del`.
42+
- Basic support for nushell has been added.
43+
44+
We have additionally made the following internal changes:
45+
46+
- The default download backend has been changed from reqwest with native-tls to reqwest with rustls.
47+
- `RUSTUP_USE_CURL` and `RUSTUP_USE_RUSTLS` can still be used to change the download backend
48+
if the new backend causes issues. If issues do happen, please [let us know](https://github.com/rust-lang/rustup/issues/3806).
49+
- The default backend now uses rustls-platform-verifier to verify server certificates, taking
50+
advantage of the platform's certificate store on platforms that support it.
51+
- When creating proxy links, rustup will now try symlinks first and fall back to hardlinks,
52+
as opposed to trying hardlinks first.
53+
- A new `RUSTUP_LOG` environment variable can be used to control tracing-based logging in
54+
rustup binaries. See the [dev guide](https://rust-lang.github.io/rustup/dev-guide/tracing.html) for more details.
55+
56+
Finally, there are some notable changes to our [official website][install] as well:
57+
58+
- The overall design of the website has been updated to better align with the Rust Project's branding.
59+
- It is now possible to download the prebuilt `rustup-init.sh` installer for the `aarch64-pc-windows-msvc` host platform via https://win.rustup.rs/aarch64.
60+
61+
Further details are available in the [changelog]!
62+
63+
## How to update
64+
65+
If you have a previous version of rustup installed, getting rustup 1.28.0 is as easy as stopping any programs which may be using Rustup (e.g. closing your IDE) and running:
66+
67+
```console
68+
$ rustup self update
69+
```
70+
71+
Rustup will also automatically update itself at the end of a normal toolchain update:
72+
73+
```console
74+
$ rustup update
75+
```
76+
77+
If you don't have it already, you can [get rustup][install] from the appropriate page on our website.
78+
79+
Rustup's documentation is also available in [the rustup book][book].
80+
81+
## Caveats
82+
83+
Rustup releases can come with problems not caused by rustup itself but just due to having a new release.
84+
As such, we recommend paying attention to the following potential issues in particular:
85+
86+
- Anti-malware scanners might be blocking rustup or stopping it from creating or copying files
87+
(especially when installing `rust-docs`, since it contains many small files).
88+
89+
- In your CI environment, rustup might fail when trying to perform a self-update.
90+
91+
This is a [known issue](https://github.com/rust-lang/rustup/issues/3709),
92+
and in the case where this issue does occur, we recommend applying the following workaround at the beginning of your workflow:
93+
94+
```console
95+
$ rustup set auto-self-update disable
96+
```
97+
98+
Also, starting from 1.28.0, rustup will no longer attempt to self-update in CI environments,
99+
so this workaround should not be necessary in the future.
100+
101+
These issues should be automatically resolved in a few weeks when the anti-malware scanners are updated to be aware of the new rustup release,
102+
and the hosted version is updated across all CI runners.
103+
104+
## Thanks
105+
106+
Thanks again to all the [contributors] who made rustup 1.28.0 possible!
107+
108+
[book]: https://rust-lang.github.io/rustup/
109+
[changelog]: https://github.com/rust-lang/rustup/blob/stable/CHANGELOG.md
110+
[contributors]: https://github.com/rust-lang/rustup/blob/stable/CHANGELOG.md#detailed-changes
111+
[install]: https://rustup.rs
112+
[rust]: https://www.rust-lang.org

0 commit comments

Comments
 (0)