Kiwix su Raspberry Pi: Wikipedia offline con Docker

Per consultare Wikipedia offline dalla rete di casa puoi usare Kiwix Serve su Raspberry Pi: scarichi un archivio ZIM, lo metti in una cartella del dispositivo e avvii il contenitore Docker ufficiale. Gli altri dispositivi potranno leggere le pagine dal browser collegandosi all’indirizzo del Raspberry Pi, anche quando Internet non è disponibile. Internet serve invece per scaricare inizialmente l’immagine Docker e i file ZIM.

Di cosa hai bisogno prima di iniziare

• Un Raspberry Pi con Raspberry Pi OS aggiornato e Docker installato e funzionante.
• Un disco o una scheda con spazio sufficiente per l’archivio scelto: le edizioni complete di Wikipedia possono essere molto grandi; controlla sempre la dimensione del singolo ZIM prima del download.
• Accesso al terminale e all’indirizzo IP locale del Raspberry Pi.
• Uno o più file ZIM scaricati dal catalogo ufficiale di Kiwix.

Non serve scaricare Wikipedia completa: puoi iniziare con un archivio piccolo, verificare il funzionamento e aggiungere successivamente file più grandi.

Come installare e avviare Kiwix Serve con Docker

La documentazione ufficiale del contenitore conferma che Kiwix Serve usa la porta 8080 e legge gli archivi ZIM dalla cartella montata come /data. Dopo aver verificato che Docker funzioni, crea una cartella sul Raspberry Pi e copia al suo interno un archivio ZIM. Nell’esempio la cartella è /home/pi/kiwix-zim e il file si chiama wikipedia.zim: sostituisci entrambi con i percorsi e nomi reali.

docker run -d --name kiwix-serve --restart unless-stopped -v /home/pi/kiwix-zim:/data:ro -p 8080:8080 ghcr.io/kiwix/kiwix-serve wikipedia.zim

Il montaggio :ro rende la cartella in sola lettura dal contenitore. Prima dell’avvio controlla che il file esista davvero e sia leggibile. Per verificare il servizio usa docker ps; in caso di errore usa docker logs kiwix-serve. Se hai già un contenitore chiamato kiwix-serve, non crearne un secondo: verifica la configurazione presente.

Come aprire Wikipedia offline da smartphone e PC

Individua l’indirizzo IP locale del Raspberry Pi, per esempio nel pannello del router. Da un dispositivo collegato alla stessa rete apri http://INDIRIZZO-IP:8080, sostituendo il segnaposto con l’indirizzo vero. L’accesso dall’esterno della LAN non è necessario per la biblioteca di casa: evita di inoltrare la porta 8080 sul router verso Internet, perché il server non è pensato come servizio pubblico autenticato.

Cosa fare se non si apre la pagina

1. Verifica che Raspberry Pi e telefono siano sulla stessa rete, e che una rete ospiti o l’isolamento Wi-Fi non impediscano la comunicazione.
2. Controlla il contenitore con docker ps e i log: un nome ZIM sbagliato impedisce al server di caricare la libreria.
3. Controlla che la porta 8080 non sia già occupata: se lo è, puoi cambiare solo la porta sul computer host, per esempio usando -p 8081:8080 e aprendo l’indirizzo con :8081.
4. Verifica permessi e spazio del disco: una cartella non leggibile o un file incompleto può far fallire il caricamento.

Quanto spazio serve e come aggiornare gli articoli

Ogni archivio ZIM è una fotografia dei contenuti al momento della sua creazione: non si aggiorna automaticamente navigando offline. Per ottenere informazioni più recenti bisogna scaricare un nuovo ZIM e sostituire il file, poi riavviare o riconfigurare il server in base al nome scelto. Prima di scaricare, confronta la dimensione del file con lo spazio libero effettivo sul supporto.

Docker oppure Kiwix senza contenitori?

Kiwix supporta anche kiwix-serve tramite pacchetti nativi, come ricorda la FAQ ufficiale. Docker semplifica l’isolamento del servizio; l’installazione nativa può essere più adatta se preferisci evitare un runtime aggiuntivo. Se stai scegliendo l’hardware, leggi anche il nostro articolo sul Raspberry Pi 4 con 8 GB di RAM; per valutare le prestazioni in altri contesti trovi il pezzo sui benchmark Raspberry Pi 5. Non sono test di Kiwix.

Il risultato è una biblioteca locale disponibile da più dispositivi. Non sostituisce una connessione Internet per consultare modifiche recentissime, ma è utile in scuole, laboratori e reti con connettività intermittente.