●Change8

Migrating to uv 0.11.0

Version 0.11.0 introduces 4 breaking changes. This guide details how to update your code.

Released: 3/23/2026

4
Breaking Changes
3
Migration Steps
4
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

uv's networking stack (reqwest upgrade)--native-tls flag--system-certs flaguv audit command

Breaking Changes

●Issue #1

The networking stack was updated, potentially causing rejection of previously trusted TLS certificates due to the upgrade of reqwest to v0.13 and changes in TLS certificate verification.

●Issue #2

Certificate verification now uses `rustls-platform-verifier` instead of `rustls-native-certs` and `webpki`. If you were using the `native-tls` option, validation behavior may change as it now delegates to the system's security library (e.g., Security.framework on macOS). Some certificate chains may now succeed or fail.

●Issue #3

The `--native-tls` flag is deprecated in favor of `--system-certs`. While `--native-tls` still works identically to `--system-certs`, users should migrate to the new flag to reduce confusion.

●Issue #4

Building uv from source on x86-64 and i686 Windows now requires NASM because `aws-lc` requires it. If NASM is not found, a prebuilt blob from `aws-lc-sys` will be used.

Migration Steps

  1. 1
    If you rely on specific TLS certificate validation behavior that might have changed due to the switch to `rustls-platform-verifier`, test your network operations thoroughly.
  2. 2
    Replace usage of the deprecated `--native-tls` flag with `--system-certs`.
  3. 3
    If building uv from source on Windows (x86-64 or i686), ensure NASM is installed or rely on the prebuilt blob provided by `aws-lc-sys`.

Release Summary

This release introduces significant updates to the networking stack, replacing certificate verification backends and deprecating the `--native-tls` flag in favor of `--system-certs`. It also includes several performance improvements and bug fixes across dependency resolution and auditing features.

Need More Details?

View the full release notes and all changes for uv 0.11.0.

View Full Changelog