Skip to content

Latest commit

 

History

History

docker

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 

Kiwix-tools Docker image

  • Available on ghcr.io.
  • multi-arch (linux/amd64, linux/arm64, linux/arm/v7)
  • based on official kiwix-tools binaries.

Usage

$ docker run -it ghcr.io/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 ghcr.io/kiwix/kiwix-tools kiwix-search /data/wikipedia_fr_test.zim "Mali"

Building and reusing

  • kiwix/kiwix-tools is multi-arch and is ideally built using buildx.
  • requires a --build-arg VERSION= with the kiwix-tools release.
  • can be built using docker build in which case it expects an additionnal --build-arg ARCH=arm for arm. Otherwise defaults to amd64.

Notes:

  • wget in alpine:3 on arm/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.download on purpose.

See also

If you are interested by a Kiwix server only container image, here it is.