Written by 18:32 Linux Views: 5

Kiwix installieren: Wikipedia offline auf NAS, Linux, CasaOS & Umbrel

Mit Kiwix holst du dir die komplette Wikipedia, medizinische Nachschlagewerke, Reparaturanleitungen und tausende Bücher komplett offline auf dein eigenes Gerät – kostenlos, quelloffen und ohne Cloud. In dieser Anleitung zeige ich dir Schritt für Schritt, wie du Kiwix auf deinem NAS (Synology & Ugreen), unter Linux, auf CasaOS/ZimaOS und auf Umbrel installierst. Alle Daten bleiben dabei dauerhaft auf deinem NAS gespeichert.

Was ist Kiwix und wie funktioniert es?

Kiwix ist ein kostenloses Open-Source-Projekt der Schweizer Non-Profit-Organisation Kiwix. Es macht komplette Webseiten offline verfügbar – ohne Internetverbindung.

Das Herzstück sind sogenannte ZIM-Dateien. Eine ZIM-Datei ist eine hochkomprimierte Kopie einer kompletten Webseite – zum Beispiel der gesamten deutschen Wikipedia mit über zwei Millionen Artikeln in einer einzigen Datei. Der Kiwix-Server liest diese Dateien ein und stellt sie in deinem Netzwerk über den Browser bereit.

Das Prinzip in drei Schritten:

  1. Kiwix-Server installieren (Docker-Container oder App)
  2. ZIM-Dateien herunterladen und in den Datenordner legen
  3. Im Browser aufrufen – fertig, dein Offline-Wissen steht bereit

Welcher Installationsweg passt zu dir?

SystemMethodeSchwierigkeit
Synology NASDocker Compose (Container Manager)Mittel
Ugreen NASDocker Compose (Container Manager)Mittel
Linux (Mint, Ubuntu, Debian)Docker Compose (Terminal)Mittel
CasaOS / ZimaOSCommunity App Store (Big Bear)Einfach
UmbrelOffizieller App StoreSehr einfach
PC, Handy, TabletKiwix Reader AppSehr einfach

Kiwix auf Synology & Ugreen NAS installieren (Docker)

Der Weg über Docker Compose funktioniert auf Synology und Ugreen NAS identisch. Beide Systeme nutzen den Container Manager, und der Pfad zu den Docker-Daten ist bei beiden /volume1/docker/.

Schritt 1: Ordner im Datei-Manager anlegen

Damit deine ZIM-Dateien dauerhaft auf dem NAS gespeichert bleiben (und nicht bei einem Container-Update verschwinden), legen wir zuerst die Ordnerstruktur an. Das machst du am besten über die grafische Oberfläche, nicht per Terminal – so vermeidest du Berechtigungsfehler.

  1. Öffne die File Station (Synology) bzw. den Datei-Manager (Ugreen)
  2. Navigiere in den freigegebenen Ordner docker (liegt unter volume1)
  3. Falls kein docker-Ordner existiert: über Erstellen → Neuer Ordner anlegen
  4. Erstelle darin einen neuen Ordner: kiwix
  5. Erstelle innerhalb von kiwix einen weiteren Ordner: zim

Deine Struktur sieht danach so aus:

/volume1/docker/kiwix/
└── zim/          ← Hier kommen später alle ZIM-Dateien rein

💡 Tipp: Plane genügend Speicherplatz ein. Die deutsche Wikipedia ohne Bilder belegt rund 15 GB, mit Bildern deutlich mehr. Die Project-Gutenberg-Bibliothek liegt bei etwa 11 GB.

Schritt 2: Projekt im Container Manager anlegen

  1. Öffne den Container Manager
  2. Wechsle links auf Projekt und klicke auf Erstellen
  3. Projektname: kiwix
  4. Pfad: wähle den Ordner /volume1/docker/kiwix
  5. Quelle: docker-compose.yml erstellen
  6. Füge die folgende Compose-Datei ein

Schritt 3: Die docker-compose.yml

Synology:

services:

  kiwix:
    image: ghcr.io/kiwix/kiwix-serve:latest
    container_name: kiwix
    restart: unless-stopped
    user: "1026:100"
    ports:
      - "8383:8080"
    volumes:
      - /volume1/docker/kiwix/zim:/data
    command: '*.zim'
    networks:
      - kiwix_net

networks:
  kiwix_net:
    driver: bridge

Ugreen:

services:

  kiwix:
    image: ghcr.io/kiwix/kiwix-serve:latest
    container_name: kiwix
    restart: unless-stopped
    user: "1000:10"
    ports:
      - "8383:8080"
    volumes:
      - /volume1/docker/kiwix/zim:/data
    entrypoint: ["/bin/sh", "-c"]
    command: ["kiwix-serve --port=8080 /data/*.zim"]
    networks:
      - kiwix_net

networks:
  kiwix_net:
    driver: bridge

Die Compose-Datei erklärt

ZeileBedeutung
imageDas offizielle Kiwix-Server-Image direkt vom Kiwix-Projekt
ports: 8383:8080Kiwix läuft im Container auf Port 8080, von außen erreichst du ihn über 8383. Ist 8383 bei dir belegt, ändere einfach die erste Zahl
volumesVerbindet deinen NAS-Ordner mit dem Datenordner im Container – dadurch bleiben alle ZIM-Dateien dauerhaft auf dem NAS gespeichert
command: '*.zim'Sagt Kiwix, dass alle ZIM-Dateien im Datenordner geladen werden sollen
restart: unless-stoppedDer Container startet nach einem Neustart des NAS automatisch wieder

⚠️ Wichtig: Der Kiwix-Server startet nur, wenn mindestens eine ZIM-Datei im Ordner liegt. Ist der Ordner leer, meldet der Container einen Fehler. Lade also zuerst eine ZIM-Datei herunter (siehe unten) und starte den Container erst danach.

Schritt 4: Container starten und aufrufen

Klicke auf Fertig bzw. Anwenden. Der Container Manager lädt das Image herunter und startet den Container. Sobald er grün leuchtet, rufst du Kiwix im Browser auf:

http://NAS-IP:8383

# Beispiel:
http://192.168.178.108:8383

Kiwix unter Linux installieren (am Beispiel Linux Mint)

Unter Linux Mint, Ubuntu oder Debian läuft Kiwix genauso über Docker – nur legst du die Ordner hier per Terminal an und startest den Container von Hand.

Schritt 1: Docker installieren (falls noch nicht vorhanden)

sudo apt update
sudo apt install docker.io docker-compose-plugin -y
sudo systemctl enable --now docker
sudo usermod -aG docker $USER

Nach dem letzten Befehl einmal ab- und wieder anmelden, damit du Docker ohne sudo nutzen kannst.

Schritt 2: Ordner anlegen

mkdir -p ~/docker/kiwix/zim
cd ~/docker/kiwix

Schritt 3: docker-compose.yml erstellen

nano docker-compose.yml

Folgenden Inhalt einfügen:

services:

  kiwix:
    image: ghcr.io/kiwix/kiwix-serve:latest
    container_name: kiwix
    restart: unless-stopped
    ports:
      - "8383:8080"
    volumes:
      - ./zim:/data
    command: '*.zim'

Mit Strg + O speichern, Enter bestätigen, mit Strg + X schließen.

Schritt 4: ZIM-Datei laden und Container starten

Lade zuerst eine ZIM-Datei direkt in den Ordner herunter – so sparst du dir den Umweg über deinen Rechner:

cd ~/docker/kiwix/zim
wget https://download.kiwix.org/zim/wikipedia/wikipedia_de_all_nopic.zim
cd ..
docker compose up -d

Danach ist Kiwix erreichbar unter http://localhost:8383 bzw. http://RECHNER-IP:8383 im Netzwerk.

Kiwix auf CasaOS & ZimaOS installieren (Community App Store)

Auf CasaOS und ZimaOS (zum Beispiel auf einem ZimaBoard) geht es deutlich einfacher – hier gibt es Kiwix als fertige App. Allerdings nicht im offiziellen App Store, sondern im Community App Store von Big Bear. Den musst du zuerst hinzufügen.

Schritt 1: Big Bear Community App Store hinzufügen

  1. Öffne den App Store in CasaOS/ZimaOS
  2. Klicke oben rechts auf die drei Punkte und wähle Add Source (Quelle hinzufügen)
  3. Füge die Quelle des Big Bear App Stores ein und bestätige (https://github.com/bigbeartechworld/big-bear-casaos/archive/refs/heads/master.zip)
  4. Der Store wird geladen und erscheint als eigene Kategorie

Schritt 2: Kiwix installieren

  1. Suche im App Store nach Kiwix
  2. Klicke auf Installieren
  3. Nach der Installation legt CasaOS automatisch den Datenordner an

Schritt 3: ZIM-Dateien einfügen

Der Datenordner der App liegt unter:

/DATA/AppData/big-bear-kiwix-serve/

Darin findest du den ZIM-Ordner. Lege deine heruntergeladenen ZIM-Dateien dort hinein – entweder über den Datei-Manager von CasaOS (Import-Funktion) oder bei großen Dateien besser direkt per SSH mit wget. Danach den Container einmal neu starten.

⚠️ Häufiger Fehler: Zeigt die App die Meldung „Dienst nicht verfügbar”, liegt das in den meisten Fällen daran, dass noch keine ZIM-Datei im Ordner liegt. Der Kiwix-Server braucht mindestens einen Inhalt, um zu starten.

Kiwix auf Umbrel installieren

Am einfachsten hast du es mit umbrelOS: Dort ist Kiwix im offiziellen App Store enthalten – du brauchst also keine zusätzliche Quelle.

  1. Öffne den App Store im Umbrel-Dashboard
  2. Suche nach Kiwix
  3. Klicke auf Install
  4. Nach der Installation erscheint Kiwix auf deinem Dashboard

Die ZIM-Dateien legst du anschließend im Datenordner der App ab. Auch hier gilt: ohne ZIM-Datei kein Inhalt.

ZIM-Dateien herunterladen – die besten Inhalte

Alle verfügbaren Inhalte findest du in der offiziellen Kiwix-Bibliothek. Es stehen über 3.000 Archive in vielen Sprachen bereit – von der Wikipedia bis zu Reparaturanleitungen.

Empfehlenswerte deutsche Archive

InhaltBeschreibungNutzen
Wikipedia (DE)Die komplette freie EnzyklopädieAllgemeinwissen
WikiMed MedizinArtikel zu Gesundheit, Hygiene, Anatomie, ArzneimittelNotfall & Gesundheit
iFixit (DE)Reparaturanleitungen mit Schritt-für-Schritt-FotosReparieren statt wegwerfen
Project GutenbergTausende kostenlose Bücher auf DeutschLesestoff & Bildung
KlexikonDie Wikipedia für KinderFamilie & Schule
Ubuntuusers WikiDas große deutsche Linux-Hilfe-WikiTechnik & Homelab

Welche Version soll ich nehmen?

Viele Archive gibt es in verschiedenen Größen. Achte auf das Kürzel im Dateinamen:

  • maxi – alle Artikel inklusive Bilder (größte Datei, beste Darstellung)
  • nopic – alle Artikel ohne Bilder (deutlich kleiner, ideal als Kompromiss)
  • mini – nur die Artikel-Einleitungen (sehr klein, für wenig Speicherplatz)

💡 Tipp für große Dateien: Die Kiwix-Server sind teilweise langsam. Zu den meisten Archiven gibt es zusätzlich einen Torrent-Link – darüber läuft der Download meist deutlich schneller und stabiler. Lade große Dateien außerdem am besten direkt auf dem NAS oder Server herunter (per SSH und wget), statt sie über deinen PC zu schieben.

Kiwix Reader: Wissen auf Handy, Tablet und PC

Neben dem Kiwix-Server gibt es die Kiwix Reader – eigenständige Apps, die ZIM-Dateien direkt auf dem Endgerät öffnen. Ganz ohne Server und ohne Netzwerk.

Server oder Reader – was ist der Unterschied?

Kiwix ServerKiwix Reader
Läuft aufNAS, Mini-PC, ServerHandy, Tablet, PC
ZugriffAlle Geräte im Netzwerk per BrowserNur das Gerät selbst
Netzwerk nötig?JaNein
Ideal fürDie Wissenszentrale zuhauseDie Notfall-Kopie für unterwegs

Für maximale Ausfallsicherheit lohnt sich die Kombination: Der Server zuhause hält alle Archive bereit, und die wichtigsten Inhalte (zum Beispiel die medizinische Enzyklopädie) liegen zusätzlich direkt auf dem Handy.

Download der Kiwix Apps

Verfügbar sind Apps für Android, iOS, Windows, macOS und Linux. Die Bedienung ist überall gleich: App installieren, ZIM-Datei laden oder importieren, fertig.

Häufige Fragen (FAQ)

Ist Kiwix wirklich kostenlos?

Ja. Kiwix ist Open Source und wird von einer gemeinnützigen Organisation entwickelt. Sowohl die Software als auch sämtliche Inhalte sind komplett kostenlos.

Wie viel Speicherplatz brauche ich für Kiwix?

Das hängt von den gewählten Inhalten ab. Die deutsche Wikipedia ohne Bilder belegt etwa 15 GB, die Project-Gutenberg-Bibliothek rund 11 GB, iFixit auf Deutsch etwa 3,5 GB. Kleine Archive gibt es bereits ab wenigen hundert Megabyte. Für ein solides Grundpaket solltest du etwa 30 bis 50 GB einplanen.

Der Kiwix-Server startet nicht – was tun?

Die häufigste Ursache ist ein leerer ZIM-Ordner. Ohne mindestens eine ZIM-Datei findet der Server keinen Inhalt und startet nicht sauber. Weitere mögliche Ursachen sind ein bereits belegter Port oder fehlende Zugriffsrechte auf den Datenordner. Ein Blick in die Container-Logs zeigt in der Regel sofort das konkrete Problem.

Funktioniert Kiwix wirklich komplett ohne Internet?

Ja. Sobald die ZIM-Dateien heruntergeladen und auf deinem Gerät gespeichert sind, brauchst du keine Internetverbindung mehr. Der Zugriff erfolgt lokal über dein Netzwerk beziehungsweise direkt auf dem Gerät. Internet benötigst du nur für den einmaligen Download der Archive und für spätere Aktualisierungen.

Wie aktualisiere ich die Inhalte?

ZIM-Dateien sind Momentaufnahmen. Um aktuelle Inhalte zu bekommen, lädst du die neuere Version aus der Kiwix-Bibliothek herunter, ersetzt die alte Datei im ZIM-Ordner und startest den Container neu. Die Archive werden in der Regel mehrmals pro Jahr neu erstellt – am Dateinamen erkennst du das Erstellungsdatum.

Kann ich Kiwix auf einem Raspberry Pi betreiben?

Ja. Neben dem normalen Docker-Weg gibt es mit Kiwix Hotspot sogar ein fertiges Betriebssystem-Image speziell für den Raspberry Pi. Der Pi spannt dabei ein eigenes WLAN auf, sodass mehrere Geräte auch komplett ohne Router und ohne Internet auf die Inhalte zugreifen können. Wegen des geringen Stromverbrauchs lässt sich das sogar über eine Powerbank oder ein kleines Solarpanel betreiben.

Brauche ich für Kiwix einen Reverse Proxy oder HTTPS?

Nein. Im lokalen Netzwerk funktioniert Kiwix problemlos über HTTP. Ein Reverse Proxy mit HTTPS ist nur sinnvoll, wenn du von außerhalb deines Heimnetzes zugreifen möchtest.

Fazit

Kiwix ist eines der faszinierendsten Selfhosting-Projekte überhaupt: Mit ein paar Klicks holst du dir das gesammelte Wissen der Menschheit auf ein Gerät, das in die Hand passt – dauerhaft, kostenlos und unabhängig von jeder Internetverbindung.

Egal ob du ein Synology- oder Ugreen-NAS, einen Linux-Server, ein ZimaBoard mit CasaOS oder ein Umbrel-System nutzt – für jede Plattform gibt es einen unkomplizierten Weg. Und ob du das Ganze für den Ernstfall, für die Kinder, fürs Reparieren oder einfach aus Faszination machst, bleibt ganz dir überlassen.

Fragen oder Probleme beim Einrichten? Schreib sie gern in die Kommentare.

(Visited 5 times, 9 visits today)
Close