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.
Warning
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.
[Deployment] HTTP_PORT = 1234 # Substitute 1234 with your desired port number
Tip
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.
[Deployment] ZIP_HTTP_PORT = 1234 # Substitute 1234 with your desired port number
Warning
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].
[Deployment] HTTP_PORT = None
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.
[Server] PROFILE = 1
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.
[Deployment] 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 |
| Haitian Creole | ht |
| 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 |
| Ukrainian | uk |
| Urdu (Pakistan) | ur-pk |
| Yoruba | yo |
| Vietnamese | vi |