Debian 8 (Jessie), Debian 9 (Stretch), Ubuntu 16.04+ and up - anything that’s not end-of-life. Ubuntu-based distributions have 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.
We recommend making sure Kolibri is not running before upgrading.
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.13, 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. Find out more details in the package repository.
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.