How to create a local Wiki server with Kiwix

Sometimes access to information may be interrupted: unstable Internet, network restrictions, requirements for a fully controlled environment. In such cases, a pre-prepared offline library comes to the rescue.

Next, we will explain in detail and clearly how to organize a local copy of Wikipedia and Arch Wiki using Kiwix and Docker.

What is Kiwix

Kiwix packages entire websites into highly compressed ZIM files. It’s convenient to store them on your phone, laptop, or send them over a local network from a small server like a Raspberry Pi.

Since ZIM is a binary format, compatible software is required: applications are available for Windows, macOS, Linux, Android, as well as official Docker images. The advantage is obvious — the content is available without the Internet.

What you will need

• Raspberry Pi (any one will do; you can also use a regular PC).
• Storage ~90 GB or more; preferably external HDD/SSD.
• Connect to a network (Ethernet or Wi-Fi) for the initial download of content.
• Keyboard and monitor for initial setup (if necessary).

Step 1: Download ZIM Files

Various sources are available in the Kiwix catalog: full Wikipedia (options with/without media), collections of articles, Arch Wiki, Project Gutenberg, TED, etc.
Select the required assemblies and download them in advance. It is practical to start with lightweight options (for example, top selections on Wikipedia), and then add larger files as needed.

Save the materials to a directory that will later be mounted in a container, for example:

/home/user/kiwix

Step 2: Deployment via Docker

Make sure Docker is installed on the device.

Option A. docker run

docker run -v /home/user/kiwix:/data -p 8080:8080 ghcr.io/kiwix/kiwix-serve '*.zim'

The command starts the Kiwix server, gives it access to ZIM files from /home/user/kiwix and publishes the web interface on port 8080 of the host. The *.zim mask tells Kiwix to serve all ZIM files in the /data directory.

Option B. docker-compose

Create a docker-compose.yml file:

version: '3'

services:

 kiwix-serve:

    image: ghcr.io/kiwix/kiwix-serve

    volumes:

      - /home/user/kiwix:/data

    ports:

      - '8080:8080'

    command: '*.zim'

Run:

docker-compose up -d

The service starts in the background and will be available on port 8080.

First launch

Open your browser and go to your device’s local network address:

http://:8080

A list of ZIM files from the /data directory will be displayed. Any of them can be opened and viewed offline: Wikipedia articles, Arch Wiki pages, etc.

Practical Notes

microSD cards are suitable for experimentation, but are not optimal for long-term storage of large ZIM files: they are more expensive per gigabyte, slower and wear out faster. For stable operation, it makes more sense to connect an external HDD or SSD — it’s both faster and more spacious.

Conclusion

A local library powered by Kiwix provides controlled, internet-independent access to knowledge. Setup via Docker takes minimal time, and expanding the collection is reduced to adding new ZIM files to the data directory. 

CONTENT:

Similar

All news