isspek / dockerized-kiwix-server

Your own wikipedia server in a box.

dockerized-kiwix-server

Step 1: Download some ZIM files

FTP site with ZIM files.

Here are some smaller ones for testing:

1. Assamese Medical Wikipedia (23 MB)
2. English Wikipedia Bollywood Articles (265 MB)
3. Simple English Wikipedia w/ No Pictures (159 MB)

Step 2: Move the ZIM files to the 'zim' directory

Move zim file to downloads.

Execute the following command to copy the files to zims

$ cp downloads/wikipedia_en_simple_all_nopic_2020-10.zim zims/

Step 3: Build the Docker container

This will create the Linux machine, download the Kiwix tools (including kiwix-serve), copy the ZIMfiles over, then create the Kiwix library XML file.

$ pwd # -> ./dockerized-kiwix-server
$ docker build -t kiwix-serve .

Step 4: Run the container

This starts the container and the Kiwix server, and makes it available on your machine at http://localhost:8080.

$ docker run -p 8080:8080 kiwix-serve

To turn it off:

$ docker ps # -> find the container id
$ docker stop <container id>

Step 5: Try it out in the browser

Go to http://localhost:8080.