Install Koha Software on Ubuntu 16.04 & 18.04 LTS

By Technical Digit

Open Terminal and get ready for Install Koha Software on Ubuntu Machine.

Update Ubuntu OS using following commands

sudo su 

apt-get update

apt-get upgrade

Install Leafpad text editor

apt-get install leafpad

Add Koha community repository

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

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

Update the software repository

sudo apt update

Install Koha

sudo apt install koha-common

Server Configuration

In this step, need to edit network information like domain name and port numbers. 

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

Here I change the port number of Koha staff client to 8080. Find the following line in the file and make changes.


Install MariaDB server

Here we use MariaDB server instead of MySQL server. Apply the following commands one by one to add MariaDB repository and install the MariaDB Server.

sudo apt-get install software-properties-common

sudo apt-key adv –recv-keys –keyserver hkp://keyserver.ubuntu.com:80 0xF1656F24C74CD1D8

sudo add-apt-repository ‘deb [arch=amd64,arm64,ppc64el] http://mirrors.up.pt/pub/mariadb/repo/10.4/ubuntu bionic main’

sudo apt update

sudo apt install mariadb-server

Assign Root password for MariaDB

sudo mysqladmin -u root password ‘newpass’       [Replace ‘newpass‘]

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

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

sudo leafpad /etc/apache2/ports.conf

Copy-paste following line below Listen 80

Listen 8080

Restart Apache,

sudo service apache2 restart

Enable modules and sites

sudo a2dissite 000-default
sudo a2enmod deflate
sudo a2ensite library
sudo service apache2 restart

Locate Koha default master password:

Run Following Command:

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

Note: Password will display in terminal, please copy and paste in login interface of koha staff client.
Restart memcached: 

sudo service memcached restart

Enable & Start Plack for Koha Performance Improvement: 

sudo koha-plack –enable library
sudo koha-plack –start  library
sudo service apache2 restart

How to start Koha
Open following links, (Staff Client) (Online Catalogue-OPAC)