mirror of
https://github.com/ollama/ollama.git
synced 2026-09-21 13:38:14 -05:00
The MLX runner accepted the API's format field but did not enforce it:
requests asking for JSON or a JSON Schema got unconstrained text, and
clients had no way to tell.
Enforce format with xgrammar: each sampling step masks the logits to
the tokens the grammar allows, so every emitted token and the end of
generation are valid under the constraint. Sampling, penalties, and
logprobs see the constrained distribution, and "json" yields a JSON
object, as the API documents and the llama-server path already
enforces. Only sampling waits on the mask; the forward pass is
dispatched before it, so constrained decoding stays pipelined.
The grammar engine is a dynamic library alongside MLX; when it is
missing, plain inference is unaffected and structured requests fail
with an explicit error. Constrained requests decode without
speculative decoding for now.
Decoding 256 tokens of a book-list schema on qwen3.8:27b-mlx (M5 Max,
seed 42, thinking off); pre-decode is the request time spent before
the first token:
unconstrained ~65 tok/s pre-decode ~70 ms
unconstrained, no draft ~32 tok/s pre-decode ~70 ms
JSON schema ~32 tok/s pre-decode ~70 ms
Schema and draft-less decoding are equal to within 0.1 tok/s in
paired adjacent requests, and a cold grammar compile adds nothing
measurable to pre-decode. The gap to unconstrained decoding is the
disabled draft model.
Fixes #16563
Co-authored-by: Daniel Hiltgen <daniel@ollama.com>
322 lines
13 KiB
Docker
322 lines
13 KiB
Docker
# vim: filetype=dockerfile
|
|
|
|
ARG FLAVOR=${TARGETARCH}
|
|
|
|
ARG ROCMVERSION=7.2.1
|
|
ARG JETPACK5VERSION=r35.4.1
|
|
ARG JETPACK6VERSION=r36.4.0
|
|
ARG CMAKEVERSION=3.31.2
|
|
ARG NINJAVERSION=1.12.1
|
|
ARG VULKANVERSION=1.4.321.1
|
|
|
|
# Default empty stages for local MLX source overrides.
|
|
# Override with: docker build --build-context local-mlx=../mlx --build-context local-mlx-c=../mlx-c
|
|
FROM scratch AS local-mlx
|
|
FROM scratch AS local-mlx-c
|
|
|
|
FROM --platform=linux/amd64 rocm/dev-almalinux-8:${ROCMVERSION}-complete AS base-amd64
|
|
RUN dnf install -y yum-utils ccache gcc-toolset-13-gcc gcc-toolset-13-gcc-c++ gcc-toolset-13-binutils \
|
|
&& yum-config-manager --add-repo https://developer.download.nvidia.com/compute/cuda/repos/rhel8/x86_64/cuda-rhel8.repo
|
|
ENV PATH=/opt/rh/gcc-toolset-13/root/usr/bin:$PATH
|
|
|
|
FROM --platform=linux/arm64 almalinux:8 AS base-arm64
|
|
# install epel-release for ccache
|
|
RUN yum install -y yum-utils epel-release \
|
|
&& dnf install -y clang ccache git \
|
|
&& yum-config-manager --add-repo https://developer.download.nvidia.com/compute/cuda/repos/rhel8/sbsa/cuda-rhel8.repo
|
|
ENV CC=clang CXX=clang++
|
|
|
|
FROM base-${TARGETARCH} AS base
|
|
ARG CMAKEVERSION
|
|
ARG NINJAVERSION
|
|
RUN curl -fsSL https://github.com/Kitware/CMake/releases/download/v${CMAKEVERSION}/cmake-${CMAKEVERSION}-linux-$(uname -m).tar.gz | tar xz -C /usr/local --strip-components 1
|
|
RUN dnf install -y unzip \
|
|
&& curl -fsSL -o /tmp/ninja.zip https://github.com/ninja-build/ninja/releases/download/v${NINJAVERSION}/ninja-linux$([ "$(uname -m)" = "aarch64" ] && echo "-aarch64").zip \
|
|
&& unzip /tmp/ninja.zip -d /usr/local/bin \
|
|
&& rm /tmp/ninja.zip
|
|
ENV CMAKE_GENERATOR=Ninja
|
|
ENV LDFLAGS=-s
|
|
|
|
#
|
|
# GPU toolchain stages — provide compilers for llama-server GPU builds
|
|
#
|
|
|
|
FROM base AS cpu-deps
|
|
RUN dnf install -y gcc-toolset-13-gcc gcc-toolset-13-gcc-c++
|
|
ENV PATH=/opt/rh/gcc-toolset-13/root/usr/bin:$PATH
|
|
|
|
FROM base AS cuda-12-deps
|
|
ARG CUDA12VERSION=12.8
|
|
RUN dnf install -y cuda-toolkit-${CUDA12VERSION//./-}
|
|
ENV PATH=/usr/local/cuda-12/bin:$PATH
|
|
|
|
FROM base AS cuda-13-deps
|
|
ARG CUDA13VERSION=13.0
|
|
RUN dnf install -y cuda-toolkit-${CUDA13VERSION//./-}
|
|
ENV PATH=/usr/local/cuda-13/bin:$PATH
|
|
|
|
FROM base AS rocm-7-deps
|
|
ENV PATH=/opt/rocm/llvm/bin:/opt/rocm/hcc/bin:/opt/rocm/hip/bin:/opt/rocm/bin:$PATH
|
|
|
|
FROM base AS vulkan-deps
|
|
ARG VULKANVERSION
|
|
RUN ln -s /usr/bin/python3 /usr/bin/python \
|
|
&& wget https://sdk.lunarg.com/sdk/download/${VULKANVERSION}/linux/vulkansdk-linux-x86_64-${VULKANVERSION}.tar.xz -O /tmp/vulkansdk.tar.xz \
|
|
&& tar xvf /tmp/vulkansdk.tar.xz -C /tmp \
|
|
&& /tmp/${VULKANVERSION}/vulkansdk -j 8 vulkan-headers \
|
|
&& /tmp/${VULKANVERSION}/vulkansdk -j 8 spirv-headers \
|
|
&& /tmp/${VULKANVERSION}/vulkansdk -j 8 shaderc \
|
|
&& cp -r /tmp/${VULKANVERSION}/x86_64/include/* /usr/local/include/ \
|
|
&& cp -r /tmp/${VULKANVERSION}/x86_64/lib/* /usr/local/lib \
|
|
&& cp -r /tmp/${VULKANVERSION}/x86_64/share/* /usr/local/share/ \
|
|
&& cp -r /tmp/${VULKANVERSION}/x86_64/bin/* /usr/local/bin/ \
|
|
&& rm -rf /tmp/${VULKANVERSION} /tmp/vulkansdk.tar.xz
|
|
ENV VULKAN_SDK=/usr/local
|
|
|
|
#
|
|
# llama-server stages — rebuild when LLAMA_CPP_VERSION, llama/server/, or llama/compat/ changes.
|
|
#
|
|
# CPU stage: llama-server + ggml-base + ggml-cpu variants → lib/ollama/
|
|
# GPU stages: GPU backend .so only → lib/ollama/<variant>/
|
|
#
|
|
|
|
FROM cpu-deps AS llama-server-cpu
|
|
COPY LLAMA_CPP_VERSION .
|
|
COPY llama/server llama/server
|
|
COPY llama/compat llama/compat
|
|
RUN --mount=type=cache,target=/root/.ccache \
|
|
cmake -S llama/server --preset cpu \
|
|
&& cmake --build build/llama-server-cpu -- -l $(nproc) \
|
|
&& cmake --install build/llama-server-cpu --component llama-server --strip \
|
|
&& for lib in \
|
|
/usr/lib64/libgomp.so* \
|
|
/usr/lib64/libomp.so* \
|
|
/opt/rh/gcc-toolset-13/root/usr/lib64/libgomp.so* \
|
|
/opt/rh/gcc-toolset-13/root/usr/lib64/libomp.so*; do \
|
|
[ -e "$lib" ] && cp -a "$lib" dist/lib/ollama/ || true; \
|
|
done
|
|
|
|
FROM scratch AS publish-llama-server-cpu
|
|
COPY --from=llama-server-cpu dist/lib/ollama /lib/ollama/
|
|
|
|
FROM cuda-12-deps AS llama-server-cuda_v12
|
|
COPY LLAMA_CPP_VERSION .
|
|
COPY llama/server llama/server
|
|
COPY llama/compat llama/compat
|
|
RUN --mount=type=cache,target=/root/.ccache \
|
|
cmake -S llama/server --preset llama_cuda_v12_linux \
|
|
&& cmake --build build/llama-server-cuda_v12 -- -l $(nproc) \
|
|
&& cmake --install build/llama-server-cuda_v12 --component llama-server --strip
|
|
|
|
FROM scratch AS publish-llama-server-cuda_v12
|
|
COPY --from=llama-server-cuda_v12 dist/lib/ollama /lib/ollama/
|
|
|
|
FROM cuda-13-deps AS llama-server-cuda_v13
|
|
COPY LLAMA_CPP_VERSION .
|
|
COPY llama/server llama/server
|
|
COPY llama/compat llama/compat
|
|
RUN --mount=type=cache,target=/root/.ccache \
|
|
cmake -S llama/server --preset llama_cuda_v13_linux \
|
|
&& cmake --build build/llama-server-cuda_v13 -- -l $(nproc) \
|
|
&& cmake --install build/llama-server-cuda_v13 --component llama-server --strip
|
|
|
|
FROM scratch AS publish-llama-server-cuda_v13
|
|
COPY --from=llama-server-cuda_v13 dist/lib/ollama /lib/ollama/
|
|
|
|
FROM rocm-7-deps AS llama-server-rocm_v7_2
|
|
ENV CC=clang CXX=clang++ CXXFLAGS=--gcc-toolchain=/opt/rh/gcc-toolset-13/root/usr
|
|
COPY LLAMA_CPP_VERSION .
|
|
COPY llama/server llama/server
|
|
COPY llama/compat llama/compat
|
|
RUN --mount=type=cache,target=/root/.ccache \
|
|
cmake -S llama/server --preset rocm_v7_2_linux \
|
|
&& cmake --build build/llama-server-rocm_v7_2 -- -l $(nproc) \
|
|
&& cmake --install build/llama-server-rocm_v7_2 --component llama-server --strip
|
|
RUN rm -f dist/lib/ollama/rocm_v7_2/rocblas/library/*gfx90[06]*
|
|
|
|
FROM scratch AS publish-llama-server-rocm_v7_2
|
|
COPY --from=llama-server-rocm_v7_2 dist/lib/ollama /lib/ollama/
|
|
|
|
FROM vulkan-deps AS llama-server-vulkan
|
|
COPY LLAMA_CPP_VERSION .
|
|
COPY llama/server llama/server
|
|
COPY llama/compat llama/compat
|
|
RUN --mount=type=cache,target=/root/.ccache \
|
|
cmake -S llama/server --preset vulkan \
|
|
&& cmake --build build/llama-server-vulkan -- -l $(nproc) \
|
|
&& cmake --install build/llama-server-vulkan --component llama-server --strip
|
|
|
|
FROM scratch AS publish-llama-server-vulkan
|
|
COPY --from=llama-server-vulkan dist/lib/ollama /lib/ollama/
|
|
|
|
#
|
|
# JetPack stages — self-contained with their own base images
|
|
#
|
|
|
|
FROM --platform=linux/arm64 nvcr.io/nvidia/l4t-jetpack:${JETPACK5VERSION} AS jetpack-5
|
|
ARG CMAKEVERSION
|
|
ARG NINJAVERSION
|
|
RUN apt-get update && apt-get install -y curl ccache git unzip \
|
|
&& curl -fsSL https://github.com/Kitware/CMake/releases/download/v${CMAKEVERSION}/cmake-${CMAKEVERSION}-linux-$(uname -m).tar.gz | tar xz -C /usr/local --strip-components 1 \
|
|
&& curl -fsSL -o /tmp/ninja.zip https://github.com/ninja-build/ninja/releases/download/v${NINJAVERSION}/ninja-linux-aarch64.zip \
|
|
&& unzip /tmp/ninja.zip -d /usr/local/bin \
|
|
&& rm /tmp/ninja.zip
|
|
ENV CMAKE_GENERATOR=Ninja
|
|
COPY LLAMA_CPP_VERSION .
|
|
COPY llama/server llama/server
|
|
COPY llama/compat llama/compat
|
|
RUN --mount=type=cache,target=/root/.ccache \
|
|
cmake -S llama/server --preset llama_cuda_jetpack5 \
|
|
&& cmake --build build/llama-server-cuda_jetpack5 -- -l $(nproc) \
|
|
&& cmake --install build/llama-server-cuda_jetpack5 --component llama-server --strip
|
|
|
|
FROM scratch AS publish-llama-server-cuda_jetpack5
|
|
COPY --from=jetpack-5 dist/lib/ollama /lib/ollama/
|
|
|
|
FROM --platform=linux/arm64 nvcr.io/nvidia/l4t-jetpack:${JETPACK6VERSION} AS jetpack-6
|
|
ARG CMAKEVERSION
|
|
ARG NINJAVERSION
|
|
RUN apt-get update && apt-get install -y curl ccache git unzip \
|
|
&& curl -fsSL https://github.com/Kitware/CMake/releases/download/v${CMAKEVERSION}/cmake-${CMAKEVERSION}-linux-$(uname -m).tar.gz | tar xz -C /usr/local --strip-components 1 \
|
|
&& curl -fsSL -o /tmp/ninja.zip https://github.com/ninja-build/ninja/releases/download/v${NINJAVERSION}/ninja-linux-aarch64.zip \
|
|
&& unzip /tmp/ninja.zip -d /usr/local/bin \
|
|
&& rm /tmp/ninja.zip
|
|
ENV CMAKE_GENERATOR=Ninja
|
|
COPY LLAMA_CPP_VERSION .
|
|
COPY llama/server llama/server
|
|
COPY llama/compat llama/compat
|
|
RUN --mount=type=cache,target=/root/.ccache \
|
|
cmake -S llama/server --preset llama_cuda_jetpack6 \
|
|
&& cmake --build build/llama-server-cuda_jetpack6 -- -l $(nproc) \
|
|
&& cmake --install build/llama-server-cuda_jetpack6 --component llama-server --strip
|
|
|
|
FROM scratch AS publish-llama-server-cuda_jetpack6
|
|
COPY --from=jetpack-6 dist/lib/ollama /lib/ollama/
|
|
|
|
#
|
|
# MLX stage
|
|
#
|
|
|
|
FROM base AS mlx
|
|
ARG CUDA13VERSION=13.0
|
|
ARG OLLAMA_MLX_BUILD_JOBS=
|
|
ARG OLLAMA_MLX_NVCC_THREADS=2
|
|
ARG MLX_CUDA_RAM_MB=
|
|
RUN dnf install -y cuda-toolkit-${CUDA13VERSION//./-} \
|
|
&& dnf install -y openblas-devel lapack-devel \
|
|
&& dnf install -y libcudnn9-cuda-13 libcudnn9-devel-cuda-13 \
|
|
&& dnf install -y libnccl libnccl-devel
|
|
ENV PATH=/usr/local/cuda-13/bin:$PATH
|
|
ENV BLAS_INCLUDE_DIRS=/usr/include/openblas
|
|
ENV LAPACK_INCLUDE_DIRS=/usr/include/openblas
|
|
ENV CGO_LDFLAGS="-L/usr/local/cuda-13/lib64 -L/usr/local/cuda-13/targets/x86_64-linux/lib/stubs"
|
|
WORKDIR /go/src/github.com/ollama/ollama
|
|
COPY CMakeLists.txt CMakePresets.json .
|
|
COPY cmake cmake
|
|
COPY mlx mlx
|
|
COPY x/mlxrunner/mlx x/mlxrunner/mlx
|
|
COPY x/mlxrunner/xgrammar/native x/mlxrunner/xgrammar/native
|
|
COPY go.mod go.sum .
|
|
COPY MLX_VERSION MLX_C_VERSION .
|
|
RUN curl -fsSL https://golang.org/dl/go$(awk '/^go/ { print $2 }' go.mod).linux-$(case $(uname -m) in x86_64) echo amd64 ;; aarch64) echo arm64 ;; esac).tar.gz | tar xz -C /usr/local
|
|
ENV PATH=/usr/local/go/bin:$PATH
|
|
RUN go mod download
|
|
RUN --mount=type=cache,target=/root/.ccache \
|
|
--mount=type=bind,from=local-mlx,target=/tmp/local-mlx \
|
|
--mount=type=bind,from=local-mlx-c,target=/tmp/local-mlx-c \
|
|
if [ -f /tmp/local-mlx/CMakeLists.txt ]; then \
|
|
export OLLAMA_MLX_SOURCE=/tmp/local-mlx; \
|
|
fi \
|
|
&& if [ -f /tmp/local-mlx-c/CMakeLists.txt ]; then \
|
|
export OLLAMA_MLX_C_SOURCE=/tmp/local-mlx-c; \
|
|
fi \
|
|
&& cmake -S . -B build/mlx_cuda_v13 -DOLLAMA_MLX_BACKENDS=cuda_v13 -DBLAS_INCLUDE_DIRS=/usr/include/openblas -DLAPACK_INCLUDE_DIRS=/usr/include/openblas -DCMAKE_CUDA_FLAGS="-t ${OLLAMA_MLX_NVCC_THREADS}" ${MLX_CUDA_RAM_MB:+-DMLX_CUDA_RAM_MB=${MLX_CUDA_RAM_MB}} -DOLLAMA_PAYLOAD_INSTALL_PREFIX=/go/src/github.com/ollama/ollama/dist \
|
|
&& cmake --build build/mlx_cuda_v13 --target ollama-mlx-cuda_v13 -- -l $(nproc) ${OLLAMA_MLX_BUILD_JOBS:+-j ${OLLAMA_MLX_BUILD_JOBS}}
|
|
|
|
FROM scratch AS publish-mlx
|
|
COPY --from=mlx /go/src/github.com/ollama/ollama/dist/lib/ollama /lib/ollama/
|
|
|
|
#
|
|
# Go build
|
|
#
|
|
|
|
FROM base AS build
|
|
WORKDIR /go/src/github.com/ollama/ollama
|
|
COPY go.mod go.sum .
|
|
RUN curl -fsSL https://golang.org/dl/go$(awk '/^go/ { print $2 }' go.mod).linux-$(case $(uname -m) in x86_64) echo amd64 ;; aarch64) echo arm64 ;; esac).tar.gz | tar xz -C /usr/local
|
|
ENV PATH=/usr/local/go/bin:$PATH
|
|
RUN go mod download
|
|
COPY . .
|
|
ARG GOFLAGS="'-ldflags=-w -s'"
|
|
ENV CGO_ENABLED=1
|
|
ARG CGO_CFLAGS
|
|
ARG CGO_CXXFLAGS
|
|
ENV CGO_CFLAGS="${CGO_CFLAGS}"
|
|
ENV CGO_CXXFLAGS="${CGO_CXXFLAGS}"
|
|
RUN --mount=type=cache,target=/root/.cache/go-build \
|
|
go build -trimpath -buildmode=pie -o /bin/ollama .
|
|
|
|
FROM scratch AS publish-go
|
|
COPY --from=build /bin/ollama /bin/ollama
|
|
|
|
#
|
|
# Assembly stages — combine llama-server variants + GPU runtime libs
|
|
#
|
|
|
|
FROM --platform=linux/amd64 scratch AS amd64
|
|
COPY --from=llama-server-cpu dist/lib/ollama /lib/ollama/
|
|
COPY --from=llama-server-cuda_v12 dist/lib/ollama /lib/ollama/
|
|
COPY --from=llama-server-cuda_v13 dist/lib/ollama /lib/ollama/
|
|
COPY --from=llama-server-vulkan dist/lib/ollama /lib/ollama/
|
|
COPY --from=mlx /go/src/github.com/ollama/ollama/dist/lib/ollama /lib/ollama/
|
|
|
|
FROM --platform=linux/arm64 scratch AS arm64
|
|
COPY --from=llama-server-cpu dist/lib/ollama /lib/ollama/
|
|
COPY --from=llama-server-cuda_v12 dist/lib/ollama /lib/ollama/
|
|
COPY --from=llama-server-cuda_v13 dist/lib/ollama /lib/ollama/
|
|
COPY --from=jetpack-5 dist/lib/ollama/ /lib/ollama/
|
|
COPY --from=jetpack-6 dist/lib/ollama/ /lib/ollama/
|
|
|
|
FROM scratch AS rocm
|
|
COPY --from=llama-server-cpu dist/lib/ollama /lib/ollama
|
|
COPY --from=llama-server-rocm_v7_2 dist/lib/ollama /lib/ollama
|
|
|
|
FROM --platform=linux/amd64 scratch AS amd64-archive
|
|
COPY --from=amd64 /lib/ollama /lib/ollama/
|
|
COPY --from=llama-server-rocm_v7_2 dist/lib/ollama /lib/ollama/
|
|
|
|
FROM --platform=linux/arm64 scratch AS arm64-archive
|
|
COPY --from=arm64 /lib/ollama /lib/ollama/
|
|
|
|
FROM ${TARGETARCH}-archive AS archive
|
|
COPY --from=build /bin/ollama /bin/ollama
|
|
|
|
FROM ${FLAVOR} AS image-archive
|
|
COPY --from=build /bin/ollama /bin/ollama
|
|
|
|
FROM ubuntu:24.04
|
|
ARG APT_MIRROR=http://archive.ubuntu.com/ubuntu
|
|
ARG APT_PORTS_MIRROR=http://ports.ubuntu.com/ubuntu-ports
|
|
RUN sed -i \
|
|
-e "s|http://archive.ubuntu.com/ubuntu|$APT_MIRROR|g" \
|
|
-e "s|http://ports.ubuntu.com/ubuntu-ports|$APT_PORTS_MIRROR|g" \
|
|
/etc/apt/sources.list.d/ubuntu.sources \
|
|
&& apt-get update \
|
|
&& apt-get install -y ca-certificates libvulkan1 libopenblas0 \
|
|
&& sed -i \
|
|
-e "s|$APT_MIRROR|http://archive.ubuntu.com/ubuntu|g" \
|
|
-e "s|$APT_PORTS_MIRROR|http://ports.ubuntu.com/ubuntu-ports|g" \
|
|
/etc/apt/sources.list.d/ubuntu.sources \
|
|
&& apt-get clean \
|
|
&& rm -rf /var/lib/apt/lists/*
|
|
COPY --from=image-archive /bin /usr/bin
|
|
ENV PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
|
|
COPY --from=image-archive /lib/ollama /usr/lib/ollama
|
|
ENV LD_LIBRARY_PATH=/usr/local/nvidia/lib:/usr/local/nvidia/lib64
|
|
ENV NVIDIA_DRIVER_CAPABILITIES=compute,utility
|
|
ENV NVIDIA_VISIBLE_DEVICES=all
|
|
ENV OLLAMA_HOST=0.0.0.0:11434
|
|
EXPOSE 11434
|
|
ENTRYPOINT ["/bin/ollama"]
|
|
CMD ["serve"]
|