Your own wikipedia server in a box.
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 6 commits ahead of jasiek:master.
Failed to load latest commit information.
scripts Update with newer builds Jun 14, 2018
.dockerignore Update with newer builds Jun 14, 2018
.gitignore Revies dockerfile Aug 15, 2017
Dockerfile Revies dockerfile Aug 15, 2017 Update README Aug 16, 2017


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

# inside the folder where you downloaded the ZIMs (e.g. ~/Downloads)
$ mkdir -p ./dockerized-kiwix-server/zims
$ cp *.zim ./dockerized-kiwix-server/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.