Initial Setup

Setting up Kolibri will be different depending on your learning environment:

  • If you plan to use Kolibri at home or for supplemental learning outside any facility, use Quick start
  • If you are installing Kolibri to be used by many learners at formal facilities like schools, or non-formal like libraries or community centers, use Advanced setup.

Note

You will only need to do the initial setup once, when you first start Kolibri after the installation. You can change all the settings later.

Quick Start

To do the initial setup of Kolibri for use at home, follow these steps.

  1. Select the default language for Kolibri.

    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. Select the Quick start setup option.

    Select Quick start for personal or home use of Kolibri.

  3. Create a super admin account. This user will be a super admin, able to manage all the content and all other Kolibri users on this device.

    Select the username and password for the super admin.

    Tip

    Make sure to save these super admin credentials in a safe place! Device super admin credentials cannot be retrieved when lost, and you will have to manually create another super admin account to manage your device.

Once you finish the initial setup, proceed to import some learning resources, and create users if more people at your home are going to be using Kolibri. Make sure to check how to configure other devices (computers, tablets or smartphones) in the home network to access Kolibri.

Advanced Setup

  1. Select the default language for Kolibri.

    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. Select the Advanced setup option, recommended for schools, educational programs, organizations, or other group learning settings that will share Kolibri.

    Select Advanced setup for use of Kolibri in group learning environments.

  3. Select the name of the device on which Kolibri server will be running from. Choose a meaningful and recognizable name because it will help you identify it during syncing and importing processes later on. If many devices are connected to your local network at the same time, the device where the Kolibri server is running must be easily recognizable for users on other devices who need to sync with it.

    Select a meaningful name for the device.

  4. Create or import a facility. In Kolibri we use the term “facility” to describe a set of user accounts, classes, and their associated data. Examples of facilities include schools, temporary learning hubs, groups of distributed at-home learners, and other situations requiring continuity between learners’ activities. At this step, you can choose to create a new facility or import one from another device.

Create a New Facility

  1. Type of facility. When you create a new facility you can choose between Non-formal (libraries, orphanages, correctional facilities, youth centers, computer labs and similar), or a Formal type of facility (schools and other formal learning contexts).

    Step 1 of 6.

    Select what type of learning environment is your facility and give it a name.

  2. Guest access.

    Step 2 of 6.

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

  3. User account creation.

    Step 3 of 6.

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

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

    Step 4 of 6.

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

  5. Create super admin account. This admin user will be a super admin, able to manage not only the content, but also all users and permissions in this facility.

    Step 5 of 6.

    Select the username and password for the facility super admin.

    Tip

    Make sure to save these super admin credentials in a safe place! Device super admin credentials cannot be retrieved when lost, and you will have to manually create another super admin account to manage your device.

  6. Responsibilities of the administrator. When you are setting up a Kolibri facility you need to take into consideration the relevant privacy laws and regulations. As super admin, you 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 6 of 6.

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

Once you finish the initial setup, proceed to import some learning resources, 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.

Import Facility

If you are part of a wider learning environment, where several learning facilities like schools or community centers are managed by one central organization, or you need to sync the learner progress data from your facility with another device where Kolibri is running, you can choose to import a facility that is already set up on that device.

  1. Click Import facility button in the Create or import facility setup step.

  2. Any device that has Kolibri running in the local network should appear in the Select network address window. Read more on how set up a local network in the Kolibri Hardware Guide.

    Select the device and click the Continue button.

    Select the network address of the device from which you want to import a facility.

    Note

    If you do not see the address of the device listed, but you know the IP address, you can add it manually. Click the Add new address link, and fill in the required information.

    Add the network address of the device manually.

    Manually add the network address of the device.

    Warning

    Firewals may impede your ability to see other devices in your local network or add them as source. If you are unable to see other devices, make sure to:

    • disable the firewalls on all the devices that you need to sync
    • restart Kolibri for broadcast to take effect
  3. Select facility. If there are several facilities on the device, select the one you want to import and provide the administrative credentials.

    Step 1 of 4.

    Select the facility you want to import and provide credentials.

    Warning

    You must have the credentials (username and password) for either the facility admin of the facility you want to import, or for the super admin of the device you are importing from.

  4. Wait for the facility data to load on your device. It may take some time, so please be patient. When you see the confirmation that the process is completed click the Continue button.

    Step 2 of 4.

    Facility successfully imported onto your device.

  5. Create a super admin account. The account you create in this step will be a super admin for your device, and be able to manage all the device content, all the facility users, and their permissions.

    You can choose to create a new super admin account or to use the credentials of the super admin of the device from where you imported the facility.

    Step 3 of 4.

    Select the super admin account.

    Tip

    Make sure to save the super admin credentials in a safe place! Device super admin credentials cannot be retrieved when lost, and you will have to manually create another super admin account to manage your device.

  6. Responsibilities of the administrator. When you are setting up a Kolibri facility, especially in formal environments like schools, you need to take into consideration the relevant privacy laws and regulations. As super admin, you 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 4 of 4.

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

Once you finish the initial setup, proceed to import some learning resources.

Note

After you close the welcoming message, you will be able to import content from the same device from which you just imported the facility.

You can use the same device from which you imported the facility also to import content.

Make sure to check how to configure other computers in the network to access Kolibri.