How to Install Koha in Ubuntu 18.04 LTS / 18.10!

     Koha is an open source Integrated Library System (ILS) used world wide by different libraries such as school, college, university special library etc. It was created in 1999 by Katipo Communications for the Horowhenua Library Trust in New Zealand. It was written in PERL and released under GNU General Public License V3 or later.

To install koha completely in Ubuntu 18.04 LTS we have to go through two processes i.e Charater User Interface installation (using terminal) and Graphical User Interface installation (using a web brower). Here the character user interface installation process discussed below.

Open Terminal by pressing Ctrl + Alt + T (Press at a time)

Step : 1 - Log in as superuser

sudo su

Enter root password

Step : 2 - Update the system

apt-get update

Step : 3 - Upgrade the system

apt-get upgrade

step : 4 - Install MySQL server

sudo apt-get install mysql-server

Step : 5 - Check MySQL version

mysql --version  

Step : 6 - Log in to MySQl

mysql -u root -p

Step : 7 - Set required permission

SET GLOBAL sql_mode='';

Next exit

Exit;


Step : 8 - Update again the system

apt-get update
apt-get upgrade

Step : 9 - Install lightweight text editor

apt-get install leafpad

Step : 10 - Add Koha community repository

wget -q -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

Step : 11 - Update again the system

apt-get update
apt-get upgrade

Step : 12 - Install Koha

apt-get install koha-common 

Step : 13 - Configure koha sites

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

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

INTRAPORT="8001"
OPACPORT="8000"

next save and quit.

Step : 14 - Create Apache configuration files.

sudo a2enmod rewrite
sudo a2enmod cgi
sudo service apache2 restart

Step : 15 - Create a Koha instance with the name library

sudo koha-create --create-db library

Step : 16 - Ubuntu MySQL security Tweak

sudo mysql_secure_installation

[Enter the MySQL Root password]

Give the answer n (no) for the first question. Give Y (Yes) for other questions.


Step : 17 - Adding ports

We have assigned 8001 port for Koha staff client and 8000 for OPAC.
Open following file and add new port.

sudo leafpad /etc/apache2/ports.conf

Copy paste following line below Listen 80

Listen 8001
Listen 8000

next save and close the fie.

Step : 18 - Restart Apache

sudo service apache2 restart

Step : 19 - Enable modules and sites

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

Step : 20 - Zebra rebuild command

koha-rebuild-zebra -v -f library

Step : 21 - See the password in koha configuaration file

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

Step : 22 - Change the password of koha_library database

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

Step : 23 - Configure MySQL for koha

sudo su

[enter the Linux Root password]

mysql -u root -p 

[enter the MySQL Root password]

use mysql;

SET PASSWORD FOR 'koha_library'@'localhost' = PASSWORD('library');

flush privileges;

quit;

Step : 24 - Restart memcached

sudo service memcached restart

Now, koha has been installed successfully

Step : 25 - Launch a web browser and put the following URL

http://127.0.1.1:8001 (Staff client)
http://127.0.1.1:8000 (Online catalogue)

Step : 26 - Web Installation 

For web installation instructions click here

Information Courtesy : https://en.wikipedia.org/wiki/Koha_(software)