Select the issue you are having from the list below.
If you are having an issue that you have not found the answer to below, please contact us at hello@kiwix.org, detailing the problem.
Voici la procédure de configuration rapide. Pour obtenir des informations plus détaillées et des conseils sur la résolution éventuelle des problèmes, veuillez consulter les instructions plus détaillées ci-dessous.
- Transférez votre fichier .img sur une carte microSD à l'aide de la fonction L'imageur Pi de Raspberry. Ne modifiez pas les paramètres au moment où il verrouille le système de démarrage.
- Insérez votre carte dans le Raspberry et mettez-le sous tension.
- Premier lancement : après 1 à 8 minutes (selon l'appareil et le disque), un réseau “ Kiwix Hotspot ” (ou le nom que vous avez choisi sur le service Imager) apparaîtra. Connectez-vous-y. Un portail captif apparaîtra.
- Suivez les instructions du portail captif qui apparaît ou tapez simplement
http://goto.kiwix.hotspotouhttp://network-name.hotspotsi vous l'avez changé dans le service Imager) dans votre navigateur préféré. Attention à taper l'adresse complète avechttp://, et non https ! - C'est tout. Naviguez et profitez !
———
Télécharger et flasher le fichier d’image
- Nous Très recommander que vous téléchargez via le torrent car il vérifie à nouveau la corruption du fichier. Assurez-vous d’utiliser Transmission (4.11+) ou un autre client webseed afin qu'il ne soit pas obligé d'attendre les autres peers avant de commencer le téléchargement.
- Lorsque vous affichez votre image sur la carte microSD avec Imagerie Raspberry Pi, Assurez-vous que votre carte dispose de suffisamment d’espace pour permettre l’installation (la taille de l’image est indiquée en haut de cette page) et laissez le processus de vérification s’effectuer entièrement afin de s’assurer que l’image a bien été copiée correctement.
- N'alterez aucune des paramètres (nom de réseau ou tout autre) car cela bloquera le système.
- Si votre carte n’est pas neuve, essayez peut-être une autre. Ces pièces sont assez fragiles et tendent à se détériorer avec le temps ; il pourrait être intéressant de les tester. Voir également ci-dessous pour les tests matériels.
Comment faire fonctionner le Raspberry Pi
- N'oubliez pas : le Raspberry Pi zéro 2W Ce mode n'est pas pris en charge encore.
- Vous devez lui accorder 5 à 8 minutes pour que le premier démarrage déballe tout et affiche le réseau ; après cela, tout sera beaucoup plus fluide.
Vérifiez votre matériel
- Téléchargez l'image gratuite à partir de Page des packs de contenu. C’est un téléchargement plus léger qui accélère les tests. S’il vous plaît Utilisez le lien torrent Pour s’assurer qu’il n’y a pas de problème avec le téléchargement (il est téléchargé depuis le même emplacement HTTPs, mais il est également sûr qu’il n’est pas corrompu).
- Insérez votre carte SD dans votre ordinateur (veuillez également veiller à disposer d’un espace suffisant sur la carte).
- Lancez le Logiciel Raspberry Pi Imager.
- Ne pas utiliser le bouton « Choisir un appareil »
- Sélectionnez le fichier d’image téléchargé via Choisissez OS -> Utiliser personnalisé (le nom du fichier doit être
demo_yyyy-mm_xxxxxxxx.imgou similaire)
- Sélectionnez la carte SD en utilisant Choisissez un stockage bouton
- Cliquez Suivant bouton
- Sélectionner Non Lorsqu'on lui a demandé Personnalisation du système d’exploitation
- Sélectionner Oui au moment de l'avertissement, vous devrez confirmer que votre carte SD sera effacée
- Faites en sorte que le processus soit terminé, y compris la partie de vérification..
-
- Insérez la carte dans le Pi.
- Assurez-vous que l’alimentation électrique soit adaptée :
- 12,5 W (2,5 A) pour Pi Zero2W, Pi3B et Pi 3B+.
Le Pi3B accepte 2,1 A mais nous recommandons la norme plus courante de 2,5 A. - 15 W (3 A) pour Pi 4 et Pi 400
- 27 W (5 A) pour Pi 5.
- 12,5 W (2,5 A) pour Pi Zero2W, Pi3B et Pi 3B+.
- Insérez le cordon d’alimentation, les lumières devraient s’allumer.
- Attendez 15 bonnes minutes (pour être sûr), soit 900 secondes.
- Utilisez un autre appareil pour rechercher un SSID nommé “ Kiwix Hotspot ”. C’est un réseau ouvert et il ne propose pas d’accès Internet ; selon votre système de test, il ne peut donc pas être considéré comme un SSID recommandé.
Suivez les instructions du portail captif qui apparaît ou tapez simplement http://goto.kiwix.hotspot ou http://network-name.hotspot si vous l'avez changé dans le service Imager) dans votre navigateur préféré. Attention à taper l'adresse complète avec http://, et non https !
Every single Kiwix Hotspot (Kiwix hardware) is manually tested before shipping, including its power-plug. This eliminates all risks associated with download, flashing, hardware defect, etc. That and the fact that we are using Solid State Drive instead of microSD card makes out-of-box issues very unlikely.
After a full year of shipping devices, the single issue we had was a defective power-plug that had us include power-plug testing in our process.
If you can’t see the WiFi network, please check first with a different phone or computer. Since December 2025, the default WiFi network use WiFi AC (also called WiFi5) over a 5Ghz frequency. That’s widely supported but some old or very low-end devices might only support 2.4Ghz networks.
If you’re confident you’ve tested with different devices that support 5Ghz, nous contacter, ideally with your serial number (found under the device). There remains a slight chance that the device or the power plug has been damaged during shipping.
After setting up your device for the first time, a non-visible WiFi network is a sign of a problem but it doesn’t tell which one. The counterpart is that if you see the WiFi network, your Hotspot is working!
First of all, check with another device. Since version 2025-12, the default WiFi network use WiFi AC (also called WiFi5) over a 5Ghz frequency. That’s widely supported but some old or very low-end devices might only support 2.4Ghz networks.
If it wasn’t the issue, check and redo the Standard Setup Procedure. Each step is important! Don’t overlook any.
- Downloads over HTTP might appear successful but be corrupt. Torrent will ensure it’s not corrupt.
- Not adding the customisation from Raspberry-Pi Imager is mandatory. As the tool records those as settings, you may have to clear them.
- Using a good-quality, in good condition (that usually means new) microSD card is decisive.
- Using the verification step of the flashing process is required. It ensures the exact content written to the microSD card could be read. A failure here would indicate the new to replace the microSD card. A success cannot 100% eliminate a microSD card issue though as only the written blocks are tested.
- Using the correct power-plug is also mandatory. An underrated power plug or a defective one (that’s more frequent than you think!) would likely boot up the Pi but wreck havoc upon startup.
- Make sure the microSD card is inserted in the Pi. We’ve all forgot it at some point 😅.
If you’ve checked all this and could not fix the issue, please contact us so we can diagnose together. If you can, please plug your Pi to a monitor and include screenshots or a screen-cast of the booting screen so we can identify error messages and clues.
Downloading a Content Bundle or Imager-service made image can be very slow. You should expect fluctuating speeds given the very large size of our images.
Constant very slow speeds are not to be expected and can turn your purchase into a very frustrating experience.
Our images are hosted by Wasabi and there is no throttling involved. If you are confident the problem is not on your end of the connection, contact us so we can check and potentially report to Wasabi: we’ve had multiple cases of inexplicably slow downloads and are trying to document them.
You are connected to the Hotspot’s WiFi network but didn’t get the Captive Portal and can’t access the Hotspot dashboard (http://goto.kiwix.hotspot)?
Check that you have no VPN software running as by nature those prevent direct connections and the out-server of your VPN provider surely has no access to your physical Hotspot.
If you are an Apple/iCloud+ User, mind that Icloud Private Relay is a VPN and must be disabled to access the Hotpost as well.
Your issues remain unsolved?
Please detail in full the issue(s) you need help with and we’ll get back to you as soon as we can. If you have a more general query, please view our FAQ before contacting us.
