Installing Xowa Wikis


Status message

If you have any questions about this page or if you find any errors, please write a message to the support wall and a Labdoo volunteer will help resolve it. Thank you for helping to improve our wiki pages.

The Tool Xowa allows access to more than 800 offline wikis so that children can read knowledge content even when they don't have access to the Internet. Remember that Xowa comes already pre-installed if you use the advanced sanitation guide. Otherwise, if you used the simple sanitation guide, you can manually install Xowa using the scripts as explained in this page.

Download XOWA as a zipped file from the Labdoo FTP server

Please check first if the needed Xowa wiki bundle is available as a tar.gz file from our FTP server If not, send an email to and we will try to prepare and upload the Xowa wiki bundle you need.

Once you download the tar.gz file from the FTP server above, please unzip it into the folder ~/home/labdoo/Public/xowa/wiki. Then run the script from (you can download this file and double-click on it) to allow access for all users.

Alternatively, if you want to download and install XOWA by yourself, there are 2 ways:

  • Version 1: only text, no pictures and no graphics (use this one if you have a small hard drive)
  • Version 2: includes version 1 plus linked pictures and graphics (recommended, as it is more user-friendly and informative, although it needs more disk space)

After you have installed Xowa, you can start it by double clicking on the Xowa starter icon that you will find in the laptop desktop.

There are 2 ways to install a specific wiki part of the Xowa suite. Scroll down the main page of Xowa, so you see "Links":

  • Import Online (supports version 1): Click in the column 'set up' on the Download link to start the download, which might last for some hours.
  • Import Offline (supports versions 1 and 2): This is the recommended method. We recommend to download by script -> select the needed wiki and language -> Category system: version 2 -> Import: click on Generate script -> repeat until your scripts contains all the needed wikis and then click on "Run script".

    A word of caution. Not every wiki is available in all languages, e.g. often wikivoyage is missing. When running an Offline Import you are able to select a non existing wiki and generate a script entry, but the script will crash when executing. So please check if a certain wiki exists first. Here is a trick on how to easily check: open 2 tabs on your browser (file -> New tab); use one tab to watch the online Import table, and the other tab to watch the offline import page; in the online page you are able to search for the needed language and wiki and quickly see if a certain wiki exists.

Matching Wiki Versions

The Xowa wikis can only be run with the same Xowa release that was used to download them. Labdoo updates Xowa every 6 months (in the beginning and in the middle of a year) to minimize the work for downloading wikis. So if you download new wikis at home and want to take a USB stick to an Edoovillage, ensure you do that with the same Xowa version that was installed in the laptops deployed at that Edoovillage.

Enabling Arbitrary Access to the Xowa Folder
Initially, only the default user 'labdoo' can access the manually installed Xowa wikis. To enable access for any other users, you can use a a script that you will also find in the desktop. This script is called (see this page). Please run this script every time educational content is installed in the folder /Public. The script starts without further input, runs for about 1 - 5 minutes, depending on the computer, and closes automatically.


Continue reading to the next page:
BOKS- Community Development Classes

Go back to read the previous page:
What scripts can NOT do