Dependencies Docker Image

[opensource-coder909]

Hi there
How can i build a docker image with the dependencies of mkdocs-material and some other plugin dependencies (I would like to install mkdocs-material via repository)?

Can someone help?
Greedings

[kamilkrzyskow]

Hello @opensource-coder909,
there is a mention on how to add plugins in the docs, basically create your own Dockerfile and add RUN commands:

• https://squidfunk.github.io/mkdocs-material/getting-started/#with-docker

I would like to install mkdocs-material via repository

There is an explanation on how to create repository builds in private registries for the Insiders version:

• https://squidfunk.github.io/mkdocs-material/insiders/getting-started/#with-docker

If that's not enough then you might want to look for a more detailed Docker tutorial specific to your needs.

[niclasheinz]

Hi @opensource-coder909

Your Dockerfile could look something like this:

# Base image with Python
FROM python:3.13-slim as base

# Install system dependencies for build tools, Cairo, and Python development
RUN apt-get update && apt-get install -y --no-install-recommends \

    git \
    wget \
    curl \
    libcairo2 \
    libcairo2-dev \
    libpangocairo-1.0-0 \
    libpango-1.0-0 \
    libgdk-pixbuf2.0-0 \
    libgtk-3-0 \
    libffi-dev \
    libnss3 \
    libxss1 \
    libasound2 \
    libatk1.0-0 \
    libatk-bridge2.0-0 \
    libcups2 \
    libdrm2 \
    libxcomposite1 \
    libxrandr2 \
    libxdamage1 \
    libgbm1 \
    gcc \
    build-essential \
    pkg-config \
    python3-dev \
    && rm -rf /var/lib/apt/lists/*

# Create and activate a virtual environment
RUN python -m venv /venv
ENV PATH="/venv/bin:$PATH"

# Upgrade pip for build-time installs
RUN pip install --no-cache-dir --upgrade pip

# Final lightweight image
FROM python:3.13-slim

# Install runtime dependencies for Cairo, Playwright, and other libraries
RUN apt-get update && apt-get install -y --no-install-recommends \

    libcairo2 \
    libpangocairo-1.0-0 \
    libpango-1.0-0 \
    libgdk-pixbuf2.0-0 \
    libgtk-3-0 \
    libffi-dev \
    libnss3 \
    libxss1 \
    libasound2 \
    libatk1.0-0 \
    libatk-bridge2.0-0 \
    libcups2 \
    libdrm2 \
    libxcomposite1 \
    libxrandr2 \
    libxdamage1 \
    libgbm1 \
    wget \
    git \
    && rm -rf /var/lib/apt/lists/*

# Copy virtual environment from the base stage
COPY --from=base /venv /venv
ENV PATH="/venv/bin:$PATH"

# Set working directory
WORKDIR /app

# Copy application code
COPY . .

# Install application dependencies (requirements.txt) and Playwright
RUN pip install --no-cache-dir -r requirements.txt 

# Get the list of all installed pip libaries
RUN pip list

# Default command
CMD ["mkdocs", "--help"]

To build this docker image, you can simply run:

docker build -t my-mkdocs-deps .

I hope this helps.

[opensource-coder909]

Thanks @kamilkrzyskow for the quick reply!

That was exactly what I was looking for, @niclasheinz thanks!