To install Kolibri on a device that will act as a server, check the hardware requirements first, and then follow the procedure for the operating system on your device.
Below you will find general recommendations regarding hardware requirements to run Kolibri. To read more detailed information and find out examples of hardware setups that have been implemented by our users, download the full Kolibri Hardware Guide and examples of Hardware Configurations for Kolibri (PDF documents).
Minimum hardware requirements to run Kolibri as a server:
- 500 MB RAM (1 GB recommended on Linux, 2GB or more on Windows devices)
- 500 MHz CPU (1 GHz recommended)
- Hard drive space depends on the size of the content channels you intend to import from Kolibri Studio or a local storage device.
If you have a facility with less than 30 computers, a device as simple as a Raspberry Pi is known to work fine as a server.
Very old desktops and very low-power computers can be used as client devices to access Kolibri. For instance, some implementations are known to use first-gen Raspberry Pi as desktop computers.
It is always a good idea to do a practical test, but when you want to implement Kolibri, usually it’s not necessary to scale your hardware. The main requirement is that your system needs a video card and driver that can play the videos.
- Supported: Windows 7, 8.1 and 10, with IE 11+, Chrome or Firefox
- Not supported: Windows XP cannot be used to install Kolibri server, but could potentially work as a client device if the browsers are as up-to-date as possible.
- Download the Windows installer for Kolibri version 0.12.
- Double-click the downloaded
- Select the language for the installation.
- Python 3 installer is included, confirm the installation or the upgrade to proceed.
- Follow the rest of the instructions in the Kolibri installation setup wizard.
- Once the installation finishes, Kolibri will auto-start and open in the default browser on your computer at http://127.0.0.1:8080. This may take a moment, so please be patient.
- Proceed with the Initial Setup of your facility.
Windows firewall will prompt you to allow the Python process needed to run Kolibri. Click Allow access to accept and proceed.
- Open the Windows Control Panel.
- Select Programs and Features option.
- Select Kolibri from the list of programs.
- Click the button Uninstall/Change and follow the instructions.
To upgrade Kolibri, follow these steps.
- Download the new version of Kolibri Windows installer.
- Double-click the downloaded
- Follow the instructions in the installation wizard window.
- Once the installation of the upgrade is finished, Kolibri will auto-start and open in the default browser on your computer.
- Go explore the new and improved Kolibri features!
Debian 8 (Jessie), Debian 9 (Stretch), Ubuntu 16.04+ and up - anything that’s not end-of-life. Ubuntu-based distributions count a number of flavors, for instance Xubuntu and Mint.
Install from PPA repository¶
In Ubuntu-based distributions, use the following commands in Terminal to add the PPA and install Kolibri:
sudo apt-get install software-properties-common dirmngr sudo add-apt-repository ppa:learningequality/kolibri sudo apt-get update sudo apt-get install kolibri
In Debian-based distributions you need to use these commands to point to our Launchpad PPA:
sudo apt-get install dirmngr sudo su -c 'echo "deb http://ppa.launchpad.net/learningequality/kolibri/ubuntu cosmic main" > /etc/apt/sources.list.d/learningequality-ubuntu-kolibri-cosmic.list' sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys DC5BAA93F9E4AE4F0411F97C74F88ADB3194DD81 sudo apt-get update sudo apt-get install kolibri
From the command line:
sudo apt-get remove kolibri.
When you use the PPA installation method, upgrades to newer versions will be automatic, provided there is internet access available.
Install from a .deb file¶
The advantages of downloading a
.deb file is the portability: you can copy the file from device to device and install Kolibri without internet access.
Download the latest .deb installer for Kolibri version 0.12, or have it copied to your local drive.
Run this command from the location where you downloaded the
sudo dpkg -i kolibri-installer-filename.deb
Wait for the installation to finish and run this command to start Kolibri:
If you choose to install Kolibri as a system service, you will not need to start it manually.
- Open Software on Ubuntu and locate the Kolibri. Press Remove.
- Or from the command line:
sudo apt-get remove kolibri.
Changing the owner of Kolibri system service¶
The system service is the script that runs Kolibri in the background when your system boots on Debian-based distributions.
You may need to change the system service to run with the permissions of a different user account. Prior to v0.10,
kolibri user account was the owner of the system service, while from v0.10 and later, desktop user’s account is preferred, in order for Kolibri to access the local USB storage.
To change the system service owner, you need to change the configuration of the system service: move the
.kolibri data folder (containing channels, databases etc.), and assign owner permissions to the new user. Follow these steps.
# Stop Kolibri sudo systemctl stop kolibri # Move data to your desktop user: sudo mv /var/kolibri/.kolibri /home/$USER/.kolibri # Change ownership sudo chown -R $USER /home/$USER/.kolibri # Change the username configuration sudo sh -c 'sudo echo -n $USER > /etc/kolibri/username' # Start Kolibri again sudo systemctl start kolibri
$USER in commands above with the name of the user you wish to be the new Kolibri system service owner.
Higher Performance with the
We have of a higher-performance wrapper around the
kolibri package for Ubuntu and Debian systems called
kolibri-server has some specific features like static content cache and optimized usage of the CPU processing power in multi core devices. For example, a Raspberry Pi 3+ device has 4 CPU cores, and with
kolibri-server it will likely be able to serve 2-3 times more client devices compared to base Kolibri.
kolibri-server follow these steps.
- Run these commands in the Terminal:
sudo apt-get install software-properties-common dirmngr sudo add-apt-repository ppa:learningequality/kolibri sudo apt-get update sudo apt-get install kolibri-server
During the installation you will be offered the option to choose the port (8000, 80 or leave the default 8080).
- Restart the system.
Keep in mind that the
kolibri-server system performance will depend not only on server device features, but on local Wi-Fi access point characteristics.
Kolibri is tested to work on Raspberry Pi Models 3, 3+, 4 and Zero W. For installation instructions, please refer to our Raspberry Pi Tutorial for Kolibri.
Kolibri may also run on Raspberry Pi Model 2, but the above tutorial was not fully intended for that model, since it does not have onboard Wi-Fi.
Other Linux & MacOS¶
- MacOS: 10.6+, all browsers supported
- Linux: Any system with Python 2.7, all browsers supported
To install Kolibri on Linux distributions other than Debian, as well as on MacOS, you can use generic installation with
pip install command, or follow these steps to run Kolibri with the
Download the PEX installer for Kolibri version 0.12.
Make sure to open the Terminal where you downloaded the
PEXfile. For example, if you saved it in the Downloads folder, type this when you open the Terminal, and press Enter:
Type the following commands next (press Enter after each one).
chmod +x kolibri-installer-filename.pex ./kolibri-installer-filename.pex start
Make sure to substitute the
kolibri-installer-filename.pexwith the exact name of the file you downloaded in both commands. For example, if the name of the downloaded file is
kolibri-v0.12.0.pex, type that instead of
Remember that PEX package allows you to run Kolibri on your system only while the process is active in the Terminal window. If that process is stopped (by either pressing Ctrl + C, closing the Terminal, or restarting your system), you will need to repeat the above steps to start Kolibri again. User accounts, classes and groups you create, as well as the content channels you download, will be available every time you restart Kolibri.
- Delete the
- Delete the
./kolibrifolder in your user’s Home directory if you want to completely remove all the Kolibri files and content channels you imported.
Python pip package¶
You can install Kolibri as a standard package from PyPi (works on Mac, Windows, and Linux) using this command:
pip install kolibri
To do the initial setup of your Kolibri facility after the installation, follow these steps.
You need to do the initial setup only once, the first time you start Kolibri after the installation. You can change all the settings later, except the type and the name of the facility.
Select the default language for Kolibri.
The default language configured for content in your browser preferences might override the language you choose in this step. To ensure that Kolibri displays in the desired language, make sure to configure it as default in the browsers of all the devices that will be used to view Kolibri content.
Facility name and type. A “Facility” is the location where you are installing Kolibri, such as a school, training center, or even your home.
Non-formal type can be used in libraries, orphanages, correctional facilities, youth centers, computer labs and similar, Formal one in schools and other formal learning contexts, and Personal should work best for parent-child or supplementary individual learning.
Formal and non-formal facilities require a name, while personal ones do not.
User account creation.
Enable passwords for learners. Simplified sign-in, without the password requirement, allows easier access for younger learners.
Create super admin account. This admin user will be a super admin, able to manage all the device content, and all the rest of the facility users and their permissions.
Make sure to save these super admin credentials in a safe place!
Data usage and privacy - responsibilities of the administrator. When you are setting up a Kolibri facility, especially in formal contexts, you need to take into consideration the relevant privacy laws and regulations. You as the super admin, or someone you delegate, will be responsible for protecting and managing the user accounts and personal information stored on the device. Review the data usage and privacy statement before finishing the facility setup.
Once you finish the initial setup, proceed to import some content, and create users (if you chose the Admin-managed facility setup). Make sure to check how to configure other computers in the network to access Kolibri.