Skip to content

# Use in Alpine Linux Docker

When using this plugin in a Docker container based on Alpine Linux, you may encounter the following error:

    LookupError: Unknown timezone UTC

This happens because Alpine Linux, being a minimal distribution, does not include timezone data by default. The babel library used by this plugin requires timezone information to function correctly.

## Solution

Install the `tzdata` package in your Alpine-based Docker image:

    # Install timezone data
    RUN apk add --no-cache tzdata

Example Dockerfile

    FROM python:3.12-alpine

    # Install timezone data for babel/mkdocs-git-revision-date-localized-plugin
    RUN apk add --no-cache tzdata git

    # Install MkDocs and plugins
    RUN pip install mkdocs mkdocs-material mkdocs-git-revision-date-localized-plugin

    WORKDIR /docs

Why this is needed

The Python `zoneinfo` module relies on system-level timezone data to resolve timezone names like "UTC". Without the `tzdata` package installed, Alpine Linux does not have this data available, causing the `LookupError`.