Koha installation process in ubuntu 20.04

 

SL: this commands have been tested with latest Ubuntu LTS ( 20.04)

Open Applications > System Tools > Terminal and execute the below commands one by one

1. Update Ubuntu using apt

sudo apt update

2. Clear the apt-get packager manager cache

sudo apt clean

3. Install MariaDB-server dependence

sudo apt install mariadb-server mariadb-client -y

4. Provide MySQL/MariaDB root password

(If the password asks during the installation process, enter the password in the window. Apply following command, if the password window did not appear during the installation secure it)

Securing MariaDB

Run this command to improve the security of the MariaDB installation:

sudo mysql_secure_installation

(The script will prompt you to set up the root user password, remove the anonymous user, restrict root user access to the local machine and remove the test database. In the end, the script will reload the privilege tables ensuring that all changes take effect immediately. All steps are explained in detail and it is recommended to answer “Y” (yes) to all questions.)

5. Add Koha community repository ( For stable - latest version )

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


6. Add trusted repository key

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

7. Update software repository

sudo apt update

8. Install Koha and dependencies

sudo apt install koha-common -y

( takes 5 mins on a reasonably fast internet connection )

9. Edit initial config file

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

Edit INTRAPORT as 8080, OPACPORT as 80, domain, and Memcached [for database, makes Koha faster] settings depending on install

10. Ensure rewrite and cgi are enabled

sudo a2enmod rewrite cgi && sudo systemctl restart apache2

11. Setup the database for Koha

sudo koha-create --create-db library

12. Add new 8080 port (for IP based install) to Apache

sudo nano /etc/apache2/ports.conf

( need to add Listen 8080 below Listen 80 )

13. Enable vhost on Apache

sudo a2dissite 000-default && sudo a2enmod deflate && sudo a2ensite library && sudo systemctl restart apache2

14. In Ubuntu 20.04 LTS Locale::Language perl module is missing shows, in order to fix it, execute the below command

sudo apt install liblocale-codes-perl

Test to ensure everything is working

In the web browser, visit http://localhost or http://127.0.0.1 {Koha maintenance message}
In the web browser, visit localhost:8080 or 127.0.0.1:8080 It will prompt for username & password

username --> koha_library
password --> get it by executing this command –>
15.
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/library/koha-conf.xml

Follow onscreen instructions/wizard create a library and a super librarian.