Docker image for Olah, a self-hosted Hugging Face mirror/proxy. A GitHub Action checks PyPI daily for a new Olah release and publishes a new image when one appears.
This project was written with AI assistance (Claude) under human supervision.
docker run -p 8090:8090 -v olah-data:/data ghcr.io/romkey/olah-docker:latestTags:
| Tag | Mean 6325 ing |
|---|---|
latest |
Newest Olah release |
X.Y.Z |
Specific Olah version (e.g. 0.5.1) |
X.Y |
Newest patch release of that minor version |
Images are multi-arch (linux/amd64, linux/arm64) and ship with SBOM and provenance attestations.
- Base:
python:3.13-slim-trixie(Debian), runs as non-root userolah. - Cached repos and logs live under the
/datavolume. - The server listens on
0.0.0.0:8090. Override by passing your own command, e.g.olah-cli --config /data/olah.toml. - Debugging tools included:
ping,host,dig,nc,curl,ip,ps.
docker run --rm ghcr.io/romkey/olah-docker:latest dig huggingface.cocompose.example.yaml is a ready-to-use starting point:
docker compose -f compose.example.yaml up -dOlah is configured with command-line flags (or a --config file), so the example overrides command. Things to adjust:
--mirror-netloc/--mirror-lfs-netloc: set these to thehost:portyour clients use to reach Olah (e.g.olah.example.com:8090), and--mirror-schemetohttporhttps.--cache-size-limit: uncomment to cap the cache size (e.g.100GB).image: pin a version tag such as0.5.1instead oflatestfor reproducible deploys.
Point Hugging Face clients at it with HF_ENDPOINT:
HF_ENDPOINT=http://localhost:8090 huggingface-cli download gpt2The cache lives in the olah-data volume. If you replace command, keep --host=0.0.0.0 or the server won't be reachable from outside the container.
- Release (daily): compares PyPI's latest Olah version with the tags in GHCR and builds if it's new.
- Weekly rebuild: republishes the current version to pick up base-image security fixes.
- Every build is smoke-tested and scanned with Trivy (results in the Security tab; fixable CRITICAL vulnerabilities fail the build).
- CI lints the Dockerfile (hadolint), workflows (actionlint) and scripts (shellcheck), then builds, tests and scans on every PR.
- A keep-alive step stops GitHub from disabling the schedule after 60 days of inactivity.
- Dependabot keeps actions and the base image current.