diff --git a/docs/concepts/python-versions.md b/docs/concepts/python-versions.md index 1e2d13a2290cf..508ee2440a1ed 100644 --- a/docs/concepts/python-versions.md +++ b/docs/concepts/python-versions.md @@ -363,11 +363,10 @@ The uv Python distributions are self-contained, highly-portable, and performant. built from source, as in tools like `pyenv`, doing so requires preinstalled system dependencies, and creating optimized, performant builds (e.g., with PGO and LTO enabled) is very slow. -These distributions have some behavior quirks, generally as a consequence of portability; and, at -present, uv does not support installing them on musl-based Linux distributions, like Alpine Linux. -See the +These distributions have some behavior quirks, generally as a consequence of portability; see the [`python-build-standalone` quirks](https://gregoryszorc.com/docs/python-build-standalone/main/quirks.html) -documentation for details. +documentation for details. Additionally, some platforms may not be supported (e.g., distributions +are not yet available for musl Linux on ARM). ### PyPy distributions diff --git a/docs/guides/integration/docker.md b/docs/guides/integration/docker.md index 50df85d6b8364..8c0376dda9c99 100644 --- a/docs/guides/integration/docker.md +++ b/docs/guides/integration/docker.md @@ -222,11 +222,11 @@ $ docker run -it $(docker build -q .) /bin/bash -c "cowsay -t hello" ENV UV_TOOL_BIN_DIR=/opt/uv-bin/ ``` -### Installing Python in musl-based images +### Installing Python in ARM musl images -While uv [installs a compatible Python version](../install-python.md) if there isn't one available -in the image, uv does not yet support installing Python for musl-based distributions. For example, -if you are using an Alpine Linux base image that doesn't have Python installed, you need to add it +While uv will attempt to [install a compatible Python version](../install-python.md) if no such +version is available in the image, uv does not yet support installing Python for musl Linux on ARM. +For example, if you are using an Alpine Linux base image on an ARM machine, you may need to add it with the system package manager: ```shell