Install Koha on Ubuntu 16.04

Install Ubuntu 16.04 and update
Koha can install on various Ubuntu flavors like Ubuntu MATE/Xubuntu/Lubuntu. Xubuntu and Lubuntu are lightweight (fast performance) Ubuntu flavors. Download Linux iso file from the Ubuntu MATE/Xubuntu/Lubuntu websites. Burn in a DVD or pen drive. Install the Linux operating system. 

Open Terminal and get ready for installation
Open Applications > System Tools > Terminal and execute commands one by one mentioned in this page.

Update Ubuntu
This process will update the Linux operating system latest by downloading new packages.

sudo su
apt-get update
apt-get upgrade

Install Leafpad text editor
Leafpad is a lightweight text editor, which require to open configuration files while the installation process of Koha.

apt-get install leafpad

Add Koha community repository
Add Koha software channel into Ubuntu.

echo deb stable main | sudo tee /etc/apt/sources.list.d/koha.list
wget -O- | sudo apt-key add -

apt-get update

Install Koha
Following command will install latest release of Koha.

apt-get 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 port number of Koha staff client to 8080. Find following line in the file and make changes.


Install MySQL server
Apply following command to install MySQL server.

sudo apt-get install mysql-server

Give a new password for root user while installation.

Koha instance creation
Apply 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

Solve MySQL 5.7 compatibility problem

Open following file,

leafpad /etc/mysql/mysql.conf.d/mysqld.cnf

Find the section [mysqld] , add following line below [mysqld]


Save the changes and close the file.

Restart MySQL,

sudo /etc/init.d/mysql restart

Add new port
We have assigned 8080 port for the Koha staff client and 80 for OPAC.
Open following file and add 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

Change Koha default master password
See the following link

Install missing PERL modules
After install need to install some PERL PERL modules using CPAN.

Koha > About Koha > Perl Modules

Find missing PERL modules in different colors.

Open a terminal and apply following command to enable CPAN.

sudo su

To install a particular PERL module, e.g.

install Test::DBix::Class

How to start Koha
Open following links, (Stff client) (Online catalogue)


No comments:

Post a Comment