From 2394bf5cde91a1f4082eb3bbbc6704a104165acb Mon Sep 17 00:00:00 2001 From: Zanie Blue Date: Fri, 6 Mar 2026 08:03:42 -0600 Subject: [PATCH] Update the platform support policy with a tier 3 section including freebsd and 32-bit windows --- docs/reference/policies/platforms.md | 29 +++++++++++++++++++--------- 1 file changed, 20 insertions(+), 9 deletions(-) diff --git a/docs/reference/policies/platforms.md b/docs/reference/policies/platforms.md index 00b55c5d88662..cef025f26477e 100644 --- a/docs/reference/policies/platforms.md +++ b/docs/reference/policies/platforms.md @@ -9,11 +9,11 @@ uv has Tier 1 support for the following platforms: uv is continuously built, tested, and developed against its Tier 1 platforms. Inspired by the Rust project, Tier 1 can be thought of as -["guaranteed to work"](https://doc.rust-lang.org/beta/rustc/platform-support.html). +["guaranteed to work"](https://doc.rust-lang.org/beta/rustc/platform-support.html#tier-1). uv has Tier 2 support -(["guaranteed to build"](https://doc.rust-lang.org/beta/rustc/platform-support.html)) for the -following platforms: +(["guaranteed to build"](https://doc.rust-lang.org/beta/rustc/platform-support.html#tier-2-with-host-tools)) +for the following platforms: - Linux (PPC64LE) - Linux (RISC-V64) @@ -23,13 +23,24 @@ following platforms: - Linux (s390x) - Windows (arm64) -uv ships pre-built wheels to [PyPI](https://pypi.org/project/uv/) for its Tier 1 and Tier 2 -platforms. However, while Tier 2 platforms are continuously built, they are not continuously tested -or developed against, and so stability may vary in practice. +uv has Tier 3 support +(["best effort"](https://doc.rust-lang.org/beta/rustc/platform-support.html#tier-3)) for the +following platforms: + +- FreeBSD (x86_64) +- Windows (i686) + +uv provides official binaries on GitHub and pre-built wheels on [PyPI](https://pypi.org/project/uv/) +for its Tier 1 and Tier 2 platforms. + +Tier 2 platforms are continuously built, but the uv test suite is not run on them and stability may +vary in practice. + +Tier 3 platforms may not be built or tested, but uv will accept patches to fix bugs. + +## Windows versions -Beyond the Tier 1 and Tier 2 platforms, uv is known to build on i686 Windows, and known _not_ to -build on aarch64 Windows, but does not consider either platform to be supported at this time. The -minimum supported Windows versions are Windows 10 and Windows Server 2016, following +The minimum supported Windows versions are Windows 10 and Windows Server 2016, following [Rust's own Tier 1 support](https://blog.rust-lang.org/2024/02/26/Windows-7.html). ## macOS versions