Customize Kolibri settings with the options.ini file

Installing Kolibri generates a default options.ini file with all the sections and values commented out with the # character at the beginning of the line. To see the options.ini file, open the .kolibri folder inside the Home folder.


Some of the values in the options.ini file, especially in the sections [Cache], [Database], and [Server] can have serious effects on the performance of your Kolibri server. Do not edit them if you are not sure how they work!

Manage server ports

Run Kolibri from a different port

If you need Kolibri to start and run from a port different than the default 8080, add the section [Deployment], and the key HTTP_PORT with the value of your desired port, to the options.ini file.

HTTP_PORT = 1234
# Substitute 1234 with your desired port number


If after setting the desired port in the options.ini file you still see Kolibri running from a different one, you probably have the environment variable KOLIBRI_HTTP_PORT from a previous installation, which takes precedence. Check the .bashrc file on Linux, or run the set command in Windows command prompt, to verify and correct if necessary.

Use different port to serve content

If you need Kolibri to serve content resources from a different port than the one server itself is running, add the section [Deployment], and the key ZIP_HTTP_PORT with the value of your desired port.

# Substitute 1234 with your desired port number


If you experience problems accessing resources served from a different port on Windows, make sure to add a rule to allow it in the Windows Defender Firewall.

Enable port autodiscovery

To enable the autodiscovery of the port where Kolibri is running, set the key HTTP_PORT with the value None in the section [Deployment].


Allow profiling of requests

If you need to profile server requests to get a more detailed information about the Kolibri performance, add the following to the options.ini file.


Configure supported languages

You can configure Kolibri to display just a specific set of languages that your implementation supports, as opposed to the full list of languages Kolibri has been localized into. Edit the options.ini file to include the key LANGUAGES under the section [Deployment], with a comma separated list of intl_code language codes.

Below example will display only English, Gujarati, Hindi, Marathi and Telugu languages in the language selector window.

LANGUAGES = 'en', 'gu-in', 'hi-in', 'mr', 'te'

Kolibri currently supports the following locales:

Language intl_code
English en
Arabic ar
Bengali bn-bd
Bulgarian bg-bg
Burmese my
Chinese (simplified) zh-hans
Chinyanja nyn
Farsi fa
French fr
Fulfulde Mbororoore ff-cm
Georgian ka
German de
Greek el
Gujarati gu-in
Hausa ha
Hindi (India) hi-in
Indonesian id
Italian it
Khmer km
Korean ko
Marathi mr
Portuguese (Brazil) pt-br
Portuguese (Mozmbique) pt-mz
Spanish (Latin America) es-419
Spanish (Spain) es-es
Swahili (Tanzania) sw-tz
Telugu te
Urdu (Pakistan) ur-pk
Yoruba yo
Vietnamese vi