Install Kolibri

See the Kolibri changelog here to review specific changes in each version of Kolibri. Documentation for previous Kolibri versions are available here.

Hardware requirements

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.

Tip

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).

Servers

Minimum hardware requirements to run Kolibri as a server:

  • 500 MB RAM (1 GB recommended)
  • 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.

Clients

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.

Windows

Compatibility

  • 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.

Install

  1. Download the Windows installer for Kolibri version 0.12.
  2. Double-click the downloaded .exe file.
  3. Select the language for the installation.
  4. Python 3 installer is included, confirm the installation or the upgrade to proceed.
  5. Follow the rest of the instructions in the Kolibri installation setup wizard.
  6. 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.
  7. Proceed with the Initial Setup of your facility.

Warning

Windows firewall will prompt you to allow the Python process needed to run Kolibri. Click Allow access to accept and proceed.

Windows security alert window that opens when Windows firewall needs your permission to allow the Python process, needed to run Kolibri, to be executed on your computer.

Allow the Python process needed to run Kolibri.

Uninstall

  1. Open the Windows Control Panel.
  2. Select Programs and Features option.
  3. Select Kolibri from the list of programs.
  4. Click the button Uninstall/Change and follow the instructions.

Upgrade

To upgrade Kolibri, follow these steps.

  1. Download the new version of Kolibri Windows installer.
  2. Double-click the downloaded .exe file.
  3. Follow the instructions in the installation wizard window.
  4. Once the installation of the upgrade is finished, Kolibri will auto-start and open in the default browser on your computer.
  5. Go explore the new and improved Kolibri features!

Debian/Ubuntu

Compatibility

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 flavours, 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

Uninstall

From the command line: sudo apt-get remove kolibri.

Upgrade

When you use the PPA installation method, upgrades to newer versions will be automatic, provided there is internet access available.

kolibri-server (pre-release)

We are finalizing the release of an optimized version of Kolibri for Linux systems called kolibri-server. This version is recommended for:

  • Clear server-client setup for implementations with many client devices
  • When the server device has more than one CPU core

kolibri-server has some specific features like static content cache and optimized usage of the CPU processing power in multi core devices. Typical use case would be a Raspberry Pi 3+ device with 4 CPU cores, which will perform much better and faster with kolibri-server compared to base Kolibri.

To install kolibri-server follow these steps.

  1. Run these commands in the Terminal:

    sudo apt-get install software-properties-common python-software-properties
    sudo add-apt-repository ppa:learningequality/kolibri-proposed
    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).

  2. Restart the system.

Warning

  • Be advised that this procedure also switches the setup to use the latest built Kolibri pre-release.
  • Keep in mind that the kolibri-server system performance will depend not only on server device features, but on local WiFi access point characteristics.

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.

  1. Download the latest .deb installer for Kolibri version 0.12, or have it copied to your local drive.

  2. Run this command from the location where you downloaded the DEB file:

    sudo dpkg -i kolibri-installer-filename.deb
    
  3. Wait for the installation to finish and run this command to start Kolibri:

    kolibri start
    

    Note

    If you choose to install Kolibri as a system service, you will not need to start it manually.

  4. When the command finishes, open the default browser at http://127.0.0.1:8080 and proceed with the Initial Setup of your facility.

Uninstall

  • Open Software on Ubuntu and locate the Kolibri. Press Remove.
  • Or from the command line: sudo apt-get remove kolibri.

Upgrade

When you use the PPA installation method, upgrades to newer versions will be automatic, provided there is internet access available.

To upgrade Kolibri on a Debian device without internet access, bring the updated .deb file and follow the same steps as in Install from a .deb file.

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

Note

Replace the $USER in commands above with the name of the user you wish to be the new Kolibri system service owner.

Raspberry Pi

To install Kolibri on RPi refer to our Raspberry Pi Tutorial for Kolibri.

Warning

Kolibri is intended for Raspberry Pi Model 3 and upwards.

Other Linux & MacOS

Compatibility

  • MacOS: 10.6+, all browsers supported
  • Linux: Any system with Python 2.7, all browsers supported

Install

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 PEX package.

  1. Download the PEX installer for Kolibri version 0.12.

  2. Make sure to open the Terminal where you downloaded the PEX file. For example, if you saved it in the Downloads folder, type this when you open the Terminal, and press Enter:

    cd Downloads
    
  3. Type the following commands next (press Enter after each one).

    chmod +x kolibri-installer-filename.pex
    ./kolibri-installer-filename.pex start
    

    Note

    Make sure to substitute the kolibri-installer-filename.pex with 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 kolibri-installer-filename.pex.

  4. When the command finishes, open the default browser at http://127.0.0.1:8080 and proceed with the Initial Setup of your facility.

Warning

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.

Uninstall

  1. Delete the PEX file.
  2. Delete the ./kolibri folder in your user’s Home directory if you want to completely remove all the Kolibri files and content channels you imported.

Upgrade

To upgrade Kolibri, follow these steps.

  1. Download the new version of Kolibri PEX installer.
  2. Start Kolibri as during the first install.
  3. Go explore the new and improved Kolibri features!

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

Initial Setup

To do the initial setup of your Kolibri facility after the installation, follow these steps.

Note

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.

  1. Select the default language for Kolibri.

    Step 1 of 7 with language options.

    Select the default Kolibri language.

    Warning

    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.

  2. 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.

    Step 2 of 7 where you need to choose a type of facility.

    Choose the type of facility.

  3. Guest access.

    Step 3 of 7 where you can allow guests to access Kolibri content without the need to create an account.

    Select if guests can access Kolibri content without the need to create an account.

  4. User account creation.

    Step 4 of 7 where you can permit anyone to create a user account for themselves, or if user accounts must be created by Kolibri admins.

    Select if anyone can create a user account for themselves, or if user accounts must be created by Kolibri admins.

  5. Enable passwords for learners. Simplified sign-in, without the password requirement, allows easier access for younger learners.

    Step 5 of 7 where you can select if learners must type in their passwords to sign-in to Kolibri, or use just their username.

    Select if learners must type in their passwords to sign-in to Kolibri.

  6. 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.

    Step 6 of 7 is where you select the username and password for the facility super admin.

    Select the username and password for the facility super admin.

    Tip

    Make sure to save these super admin credentials in a safe place!

  7. 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.

    Step 7 of 7 requires you to review the super admin responsibilities regarding the data usage and privacy.

    Review the super admin responsibilities regarding the data usage and privacy.

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.