# Ultralytics 🚀 AGPL-3.0 License - https://ultralytics.com/license # Builds ultralytics/ultralytics:latest-arm64 image on DockerHub https://hub.docker.com/r/ultralytics/ultralytics # Image is aarch64-compatible for Apple M1, M2, M3, Raspberry Pi and other ARM architectures # Start FROM Ubuntu image https://hub.docker.com/_/ubuntu with "FROM arm64v8/ubuntu:22.04" (deprecated) # Start FROM Debian image for arm64v8 https://hub.docker.com/r/arm64v8/debian (deprecated) # Start FROM official arm64v8 Ubuntu 24.04 image https://hub.docker.com/layers/arm64v8/ubuntu/24.04/ FROM arm64v8/ubuntu:24.04 # Set environment variables (suppress PyTorch NNPACK warnings) ENV PYTHONUNBUFFERED=1 \ PYTHONDONTWRITEBYTECODE=1 \ PIP_NO_CACHE_DIR=1 \ PIP_BREAK_SYSTEM_PACKAGES=1 \ TORCH_CPP_LOG_LEVEL=ERROR # Downloads to user config dir ADD https://github.com/ultralytics/assets/releases/download/v0.0.0/Arial.ttf \ https://github.com/ultralytics/assets/releases/download/v0.0.0/Arial.Unicode.ttf \ /root/.config/Ultralytics/ # Install linux packages # TensorFlow on aarch64 may require pkg-config and libhdf5-dev if h5py builds from source. RUN apt-get update && \ apt-get install -y --no-install-recommends \ python3-pip git zip unzip wget curl htop gcc libgl1 libglib2.0-0 gnupg && \ apt-get clean && \ rm -rf /var/lib/apt/lists/* # Create working directory WORKDIR /ultralytics # Copy contents and configure git COPY . . RUN sed -i '/^\[http "https:\/\/github\.com\/"\]/,+1d' .git/config && \ sed -i'' -e 's/"opencv-python/"opencv-python-headless/' pyproject.toml ADD https://github.com/ultralytics/assets/releases/download/v8.4.0/yolo26n.pt . # Install pip packages, create python symlink, and remove build files RUN python3 -m pip install uv && \ uv pip install --system -e ".[export]" --break-system-packages && \ # Creates a symbolic link to make 'python' point to 'python3' ln -sf /usr/bin/python3 /usr/bin/python && \ # Remove extra build files rm -rf /root/.config/Ultralytics/persistent_cache.json # Usage -------------------------------------------------------------------------------------------------------------- # Production builds: https://github.com/ultralytics/ultralytics/blob/main/.github/workflows/docker.yml # Example (build): t=ultralytics/ultralytics:latest-arm64 && docker build --platform linux/arm64 -f docker/Dockerfile-arm64 -t $t . # Example (push): docker push $t # Example (pull): t=ultralytics/ultralytics:latest-arm64 && docker pull $t # Example (run): docker run -it --ipc=host $t # Example (run-with-volume): docker run -it --ipc=host -v "$PWD/shared/datasets:/datasets" $t