I noticed that my simple python3 docker image with uv has an unexpected number of downloads, so I decided to steal some traffic from the original https://docs.astral.sh/uv/guides/integration/docker/ page.
¶ What is uv?
uv is a fast Rust-based Python package tool.
It replaces pip for this build. It also replaces python3 -m venv ./venv,
and probably more by the time I reread this.
¶ Minimal uv Dockerfile
Do not use my old one and two. Use the multi-stage build:
ARG BASE_IMAGE=python:3.14-slim-trixie
ARG UV_VERSION=0.10.4-python3.14-trixie-slim
FROM ghcr.io/astral-sh/uv:$UV_VERSION AS uv_carrier
FROM $BASE_IMAGE AS builder
COPY --from=uv_carrier /usr/local/bin/uv /usr/local/bin/
RUN uv venv /opt/venv
ENV PATH=/opt/venv/bin:$PATH
COPY ./requirements.txt requirements.txt
RUN uv pip install -r requirements.txt
FROM $BASE_IMAGE
ENV PYTHONUNBUFFERED=1 \
PATH=/opt/venv/bin:$PATH
COPY --from=builder /opt/venv /opt/venv
COPY . /opt/app
RUN python -m compileall -q -j 0 /opt/app
WORKDIR /opt/app
¶ CI verdict: use uv where it saves time
I don’t spend time wiring uv into every local shell. CI is different. There it saves time on every build. Use it there.
Comments
Nothing yet. Say the first thing.
Sign in to join the conversation.