README.md

WikiTeq Umami Docker Image

Custom Umami image with BASE_PATH=/umami for subpath deployment.

Repository structure

• src/ - git submodule umami-software/umami
• Dockerfile - multi-stage image build
• scripts/ - runtime scripts (umami-entrypoint.sh, umami-init.sh, load-secrets.sh)
• .github/workflows/docker-image.yml - CI build and push to GHCR

Local build

# Initialize submodule
git submodule update --init --recursive

# Build image
docker build --build-arg BASE_PATH=/umami -t wikiteq-umami:local .

Update Umami version

cd src
git fetch --tags
git checkout vX.Y.Z
cd ..
git add src
git commit -m "Update Umami source to vX.Y.Z"

Image tags in CI

• Pull request: pr-<number>
• master: latest and <date>-<short_sha>
• Git tag: <tag>

Release policy

• Prefer immutable tags (<date>-<short_sha> or release tag) in production.
• latest is mutable and intended for development/testing only.
• For strict reproducibility, pin runtime deployments by image digest from GHCR.