Skip to content

Update the platform support policy with a tier 3 section including freebsd and 32-bit windows #18345

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
zanieb merged 1 commit into from
Mar 7, 2026
Merged

Update the platform support policy with a tier 3 section including freebsd and 32-bit windows #18345

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 20 additions & 9 deletions docs/reference/policies/platforms.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand All @@ -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)

@konstin konstin Mar 6, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm hesitant to state support for 32-bit Windows since all supporting 32-bit processors are EOL (https://support.microsoft.com/en-us/windows/32-bit-and-64-bit-windows-frequently-asked-questions-c6ca9541-8dce-4d48-0415-94a3faa2e13d#id0ebbh=windows_11) and you can run 32-bit applications on 64-bit Windows (even though you really shouldn't be running 32-bit Python anymore)

@zanieb zanieb Mar 6, 2026 •
edited
Loading

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

But we're building official binaries for i686-pc-windows-msvc so it's definitely in tier two right now? it seems like a stretch to say we don't support it at all

@zanieb zanieb Mar 6, 2026 •
edited
Loading

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If / when we drop those, we could consider removing it? though I think tier three is already an understatement


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
Expand Down
Loading