⌂ Self-hosting

Kiwix: Wikipedia and other offline libraries on your home server

Hosting Wikipedia, dictionaries and manuals without Internet using Kiwix: ZIM files, which variants to pick, kiwix-serve on the LAN and periodic updates.

We take it for granted that Wikipedia is always a click away. Yet there are many situations where the connection is missing or unreliable: a country house, a boat, a line fault that lasts for days, a school lab without Internet access. Kiwix lets you keep a complete copy of Wikipedia and many other resources at home, available from any device on the local network. It is one of the simplest and most rewarding projects to host.

How Kiwix works

Kiwix is based on a file format called ZIM, which contains an entire website compressed and indexed in a single file: text, images, internal links and a search index. A Kiwix reader opens the file and displays it as if it were the original site, with no connection needed.

There are readers for computers, Android and iOS, but for a household the most convenient solution is kiwix-serve: a small server that makes ZIM files available on the local network through a browser. Every device in the house can consult them without installing anything.

What you can download

The Kiwix catalogue does not include only Wikipedia. Among the available content are:

  • Wikipedia in a great many languages.
  • Wiktionary, Wikibooks, Wikivoyage and other Wikimedia Foundation projects.
  • Project Gutenberg books, works in the public domain.
  • Collections of Stack Exchange questions and answers on technical topics.
  • Technical documentation for programming languages and tools.
  • Educational content and instructional videos in compressed form.

Choosing the right variant

For many items, Wikipedia in particular, Kiwix offers different variants. The choice depends on the available space and the intended use:

Variant Content Suited to
maxi Full articles with images General use, if space is not an issue
nopic Full articles without images Limited space, text-based reference
mini Only the introduction of each article Small devices, quick lookups

There are also themed selections, for example on medicine, history or mathematics, much smaller than the whole encyclopedia. The full English Wikipedia with images takes up tens of gigabytes; smaller language editions take less, but remain sizeable files. Before downloading, check the sizes listed in the catalogue.

Installing kiwix-serve

The simplest route is the official container image. You create a folder for the ZIM files, mount it in the container and start the server, specifying the files to publish:

docker run -d --name kiwix -p 8080:8080 \
  -v /srv/kiwix:/data ghcr.io/kiwix/kiwix-serve '*.zim'

Opening the server's address in a browser shows a page with all the available content, each with its own internal search. The resources needed are modest: kiwix-serve runs well even on a mini PC or a low-power board, and speed depends mostly on the disk.

Downloading files efficiently

ZIM files are large, so it pays to download them robustly. The catalogue offers direct links and, for many files, torrents as well, which resume after an interruption and verify data integrity. On a slow connection you can leave the download running overnight. For very large files, check free space before starting, bearing in mind that during an update it is best to have both the old and the new version on disk.

Updates

ZIM files are snapshots: they represent content at a given moment. Wikipedia changes constantly, and new versions of the files are published at regular intervals. For home use there is no need to update often; once every few months is more than enough. The procedure is simple:

  1. Download the new file alongside the old one.
  2. Restart kiwix-serve with the new file.
  3. Check that it works and delete the old one.

Practical uses at home

Kiwix is useful in contexts that go beyond emergencies:

  • Children studying: reference without distractions, adverts or social networks.
  • Second homes or travel: an external disk with ZIM files and a laptop are enough to carry an encyclopedia anywhere.
  • Technical documentation: consulting programming manuals even when the network is down.
  • Reference archive: keeping a stable copy of content that may change.

In short

  • Kiwix packs entire sites such as Wikipedia into a single ZIM file, readable without Internet.
  • kiwix-serve makes the content available to the whole home network through a browser.
  • The maxi, nopic and mini variants balance completeness against space.
  • Torrents make downloading large files more reliable.
  • An update every few months is enough for home use.
MM
Marco Marzaduri

Marco Marzaduri works in cybersecurity, digital forensics and web development. A computer science graduate, he combines rigorous technical analysis with attention to the people who use technology.

Read also