Koha Installation Guide

Koha Installation on Ubuntu

Command Line Installation Guide

i About This Guide

• Step-by-step instructions for installing Koha on Ubuntu
• Includes system preparation, repository setup, and service configuration
• Essential for setting up a Koha instance for library management

1. Switch to Root User

sudo su

2. Update and Upgrade the System

sudo apt update

sudo apt upgrade

3. Add Koha Repository

Add Repository and Import GPG Key

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 -

sudo apt update

4. Install Dependencies

Install MariaDB Server

sudo apt install -y mariadb-server

sudo mysqladmin -u root password root

5. Install Koha Common Package

sudo apt install -y koha-common

6. Configure Koha Environment

Set Koha Intraport

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

Add or modify the following line in the file:

INTRAPORT="8191"

7. Setup Apache Web Server

Enable Apache Modules

sudo a2enmod rewrite

sudo a2enmod cgi

Restart Apache Service

sudo service apache2 restart

8. Create Koha Instance

sudo koha-create --create-db library

9. Configure Apache Ports

sudo nano /etc/apache2/ports.conf

Add the following line below Listen 80:

Listen 8191

Restart Apache Service Again

sudo service apache2 restart

10. Disable Default Site and Enable Library Site

sudo a2dissite 000-default

sudo a2enmod deflate

sudo a2ensite library

Final Apache Restart

sudo service apache2 restart

11. Start Koha Services

Restart Memcached

sudo service memcached restart

12. Koha Web Installer

Access via Browser:

http://localhost:8191

13. Koha Login Credentials

Login User

Username: koha_library

Retrieve Password

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

Password Protected

Please enter the password to view the Koha installation instructions.

Incorrect password. Please try again.