Koha – Installation

Koha is the first Open Source Integrated Library Management System (ILMS) which includes Acquisition, Cataloguing, Circulation, Serial Control & Online Public Access Catalogue with many more advanced features. Koha supports International library standards and protocols which ensures interoperability between Koha & any other library management system. It supports technologies and international standards such as MARC 21, RFID, z39.50, web 2.0 etc. The software is fully customizable and includes all modules expected in any standard library management system.

Salient Features:

  • Supports International Standards & Protocol such as MARC 21, z39.50 etc.
  • Supports Import/Export data compatible to MARC
  • Multilingual & Strong Web OPAC
  • Comprehensive advance search
  • Flexibility to customize online public access catalogue according to your library needs
  • OPAC can be used as Content Management System
  • Printing functions for barcode labels, patron cards and reports
  • Virtual Book Shelf & Course Reserve
  • Supports copy cataloguing
  • Provision to have branch libraries and Items transfers
  • Budget & Fund Management
  • Customizable Data Entry Sheet (In different framework) & supports import/export MARC framework
  • No platform dependency. It can run on Linux, Windows etc.
  • It uses MySQL as backend RDBMS and Apache Web server (Open Source Software)
  • Support Multiple Instances (One can create more than 1 library with different database)

Installation of Koha on Ubuntu/Lubuntu 14.04 LTS:

Before starting the Installation of Koha, it is assumed that you have successfully installed either Ubuntu or Lubuntu in your system. Once you finish the Installation of Linux system (Lubuntu/Ubuntu), ensure your system is connected with Internet preferably having static IP address.

Step 1: Open the Terminal:

To open the terminal, either you can search the Terminal or you can press CTRL+ALT+T together which will open terminal.

Step 2: Login with Root Privilege:

Once your terminal is ready, you need to login with root privilege and for that run this command in terminal.

sudo su (Hit Enter) It will ask password. Enter the password carefully as it will not be visible.

(Enter Password)

Step 3: Update the Ubuntu/Lubuntu:

In order to proceed with Installation of koha, you need to update the system with the following command.

Run this command in terminal:

apt-get update

Step 4: Installation of Editor:

You may have to change the configuration at many steps so keep any editor installed in your system. Some of the famous editors are NANO, GEDIT, LEAFPAD.

To install just run this command:
apt-get install gedit

NOTE: But remember if you are installing GEDIT. This will not work in the Server Edition of Linux OS.

Step 5: Add Koha community repository to the System:

Now, you need to add the koha channel into Ubuntu/Lubuntu.

Run the following command one after another in terminal

wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add –

echo deb http://debian.koha-community.org/koha stable main | sudo tee /etc/apt/sources.list.d/koha.list

After adding the channel successfully, update the system again with the following command:

apt-get update

Step 6: Installation of Koha:

Once your system is updated, run the following command to install the latest release of koha.

apt-get install koha-common

This command will enable the system to start downloading the koha with required files and packages.

During downloading and installing, it may ask you provide some input. Proceed with default values.


Step 7: Important Notes:

After downloading the required koha packages, you may get the following error on the screen (terminal).

Step 8: Resolve the Issues and Proceed:

To resolve the issues, proceed with the following commands in terminal:

sudo a2dismod mpm_event
sudo a2enmod mpm_prefork
sudo service apache2 restart

sudo apt-get install -f

Step 9: Important Configuration on koha Server:

Koha Library Management System has two interfaces:

  1. Koha Staff Interface which allows the Library Staff to carry out the library work in the system.
  2. Koha Online Public Access Catalogue which works as a mirror to display the bibliographical details of the items entered in the system. Generally, Online Public Access Catalogue is for library users to know about details of the items and their personal checkout history as well.

In this you have to configure two different ports for Koha Interface and Koha OPAC:

In order to change the port, open the (koha-sites.conf) file with any editor.

sudo gedit /etc/koha/koha-sites.conf

Generally, I use two ports 8000 for OPAC and 8001 for Interface. The reason I do this because, I want to keep the port 80 free so that I can run any other application without any difficulty.

When the file is open I change the port

8000 – Koha OPAC (OPACPORT)

8001 – Koha Interface (INTRAPORT)

Fine the lines in file and make the changes accordingly.



Step 10: Installation of MySQL Database:

To store the information, we require a database where we can store the information and use the same accordingly. This database will also enable to take the backup for future use.

Run the following command in terminal to install the MySQL database.

sudo apt-get install mysql-server

While installing, system may ask you to provide the password for root user of MySQL. Enter the password and keep the password safely as you will require this when you have to connect the MySQL database for any purpose mostly taking the backup.

Step 11: Create the Koha Instance:

To stand in safer side and avoid error before you create Koha Instance, run the following commands in order one after another.

sudo a2enmod rewrite
sudo a2enmod cgi

Restart the Apache Server:

Run this command to restart the Apache Server.

sudo service apache2 stop

sudo service apache2 start


sudo service apache2 restart

Step 12: Create Instance with the name ‘library’:

To create the same, run this command:

sudo koha-create –create-db library

Step 13: Adding ports:

The ports which you have opted to run the Koha Interface and Koha OPAC, the same ports you will have to configure in Apache Server also.

To make changes, open the following file with any editor.

sudo gedit /etc/apache2/ports.conf

Find the line Listen 80 in the file. You can use (CTRL+F) command to locate the words in the file.

Listen 8000

Listen 8001

Now, Restart Apache Web Server,

sudo service apache2 restart

Enable modules and sites

sudo a2dissite 000-default
sudo a2enmod deflate
sudo a2ensite library

Now, Restart Apache Web Server,

sudo service apache2 restart

Generate the Master Password for Koha Web Installer:

Run this command to get the password:

Step 14: Start web installation of Koha

The username to log in with will be koha_library and the password can be located in the file /etc/koha/sites/library/koha-conf.xml

Apply the following command in terminal to see the koha login password,

sudo xmlstarlet sel -t -v ‘yazgfs/config/pass’ /etc/koha/sites/library/koha-conf.xml

Step 15: Start Koha and finish the Installation with Web Installer:

Open following links, or http://localhost:8001 (Koha Staff client) or http://localhost:8000 (Koha Online Public Access Catalogue)

Once you login with credentials, you will get the Web Installer of Koha. Just opt the default settings and finish the Installation.



  1. http://kohageek.blogspot.in/2015/05/install-koha-on-ubuntu-1404.html
  2. http://koha-community.org
Is this Page useful? Useful Useless 7 of 12 people say this Page is useful.