mirror of
https://github.com/kiwix/kiwix-tools.git
synced 2025-12-23 22:28:10 -05:00
- using alpine's dumb-init to remove builder - simplifying arch management - extracting to final location
Kiwix-tools Docker image
- Available on docker.io and ghcr.io.
- multi-arch (
linux/amd64,linux/arm64,linux/arm/v7) - based on official
kiwix-toolsbinaries.
Usage
$ docker run -it kiwix/kiwix-tools:3.1.2
Welcome to kiwix-tools! The following binaries are available:
kiwix-manage kiwix-search kiwix-serve
kiwix-tools operates on zim files. You shall mount a volume to access the files.
docker run -v $(pwd):/data -it kiwix/kiwix-tools kiwix-search /data/wikipedia_fr_test.zim "Mali"
Building and reusing
kiwix/kiwix-toolsis multi-arch and is ideally built usingbuildx.- requires a
--build-arg VERSION=with the kiwix-tools release. - can be built using
docker buildin which case it expects an additionnal--build-arg ARCH=armfor arm. Otherwise defaults toamd64.
Notes:
wgetinalpine:3onarm/v7(inside github action only) crashes when downloading from HTTPs locations. Keep http-only in Dockerfile.- Was also unhappy when using the mirrors so it's using
mirror.downloadon purpose.