Install KOHA on Ubuntu

KOHA Installation on Ubuntu 16.04 LTS

Install KOHA on Uuntu. KOHA may be installed on various Ubuntu flavors like Xubuntu/Lubuntu. Xubuntu and Lubuntu are lightweight (fast performance) Ubuntu flavors. Download Linux ISO file from either Xubuntu/Lubuntu from websites. Burn in a DVD or pen drive/DVD. Install the Linux operating system.

In this demonstration, we will use Ubuntu 16.04 LTS which is downloaded from:

Desktop Image: 32 bit & 64 bit

Server Image:  32 bit & 64 bit

If you are new to Linux and don’t know the command-based operation of Linux systems then it’s preferred to go for Desktop Image. For low-end PC/Servers, go for 32 Bit operating system.

Koha Installation Steps

Login in the terminal as a root

sudo -i

Update Ubuntu OS

sudo apt-get update

Install tasksel so that we may install LAMP Stack

sudo apt-get install tasksel

Run tasksel

sudo tasksel

Select packages from tasksel

Select below two packages from the list and press the tab to continue

*LAMP Server

*Basic Ubuntu Server

Note: installation in the LAMP server will ask for Mysql password, note down somewhere.

Update Ubuntu OS

sudo apt-get update

Add Koha community repository

For koha version 16.05 stable version

echo ‘deb 16.11 main’ | sudo tee /etc/apt/sources.list.d/koha.list

For 17.11 stable version

echo ‘deb 17.11 main’ | sudo tee /etc/apt/sources.list.d/koha.list

For latest version

echo deb stable main | sudo tee/etc/apt/sources.list.d/koha.list


wget -O- | sudo apt-key add –

Update Ubuntu OS

sudo apt-get update

Install Koha

sudo apt-get install koha-common

For Server configuration, Open the below file:

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

And update/modify as below:


Koha integration with Apache creation: Apply the following commands to create Apache configuration files.

                sudo a2enmod rewrite

                sudo a2enmod cgi

                sudo service apache2 restart

Create a Koha instance with the name library

                sudo koha-create –create-db library

Add new port

We have to assign 8080 ports for the Koha staff client and 80 for OPAC. Open the following file and add a new port.

                sudo gedit /etc/apache2/ports.conf

Copy-paste following line below Listen 80

                Listen 8080

Restart Apache to make the above changes effective,

                sudo service apache2 restart

Enable Koha modules and sites

                sudo a2dissite 000-default

                sudo a2enmod deflate

                sudo a2ensite library

                sudo service apache2 restart

You may open the following link in the web browser to open the staff client of KOHA and set up the library:

To login KOHA Staff interface, superlibrarian login details are required, which may be obtained through the below command

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

Search for <user> koha_library</user> in ‘koha-conf.xml’ file and you will get <pass>asdfdsretw</pass> password.


1. Mr. Vimal,
2. Indranil Das Gupta,