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
[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
[Deployment] 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.
[Deployment] ZIP_HTTP_PORT = 1234 # 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] 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
[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:
|Spanish (Latin America)||