KOHA Installation

Koha Library System Installation Guide

Welcome to the Koha Library System Installation Guide! This tutorial will guide you through the process of installing Koha on your Ubuntu server. Let’s get started!

Note: Before proceeding, ensure you have Ubuntu and LAMP installed on your computer.For LAMP Installation refer to LAMP.

1. Update Ubuntu

Start by updating your system’s package lists and upgrading installed packages:

sudo apt-get update
sudo apt-get upgrade

2. Add Koha Community Repository

Add the Koha community repository to your sources list:

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

Add the repository key:

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

3. Check for Updates

Update your package lists to include the new repository:

sudo apt-get update

4. Install Koha

Install the Koha library system:

sudo apt-get install koha-common

This will install Koha on your computer. The installation may take some time. Press y when prompted to continue and wait until the installation completes.

5. Configure Koha

Open the configuration file to set your domain name and port:

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

In the file, search for INTRAPORT and modify the value as needed, e.g., INTRAPORT="8001". Use port 8080 for IP-based installations.

6. Install MySQL

Install the MySQL server:

sudo apt-get install mysql-server

Create a user or refer this MySQL - User Management.

7. Koha Instance Creation

Enable necessary Apache modules:

sudo a2enmod rewrite  
sudo a2enmod cgi  

Restart the Apache service:

sudo service apache2 restart

Create a new Koha instance with the following command:

sudo koha-create --create-db instance_name

For example:

sudo koha-create --create-db library

8. Add Port

To add a port, modify the ports.conf file:

sudo gedit /etc/apache2/ports.conf

Add the following line below Listen 80:

Listen 8001

Restart Apache to apply the changes:

sudo systemctl restart apache2

9. Enable Modules and Sites

First, disable the default site:

sudo a2dissite 000-default

Enable the deflate module:

sudo a2enmod deflate

Now, enable your Koha site:

sudo a2ensite instance_name

For example, if your instance name is library:

sudo a2ensite library

Restart Apache to apply all changes:

sudo systemctl restart apache2

Restart the Memcached service:

sudo service memcached restart

10. Retrieve Username and Password

There are two ways to retrieve the username and password:

1. Use the command line:

    sudo koha-passwd instance_name
   

   For example:

    sudo koha-passwd library
   

   The username and password will be displayed directly in the terminal. Copy and paste them into a text editor or notepad.

2. Open the XML file and search for the credentials:

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

   Use the search function (ctrl+f) to locate the username and password within the file.

11. Access the Koha Home Page

Open your web browser and enter the following URL to access the Koha home page:

http://127.0.0.1:8001

---

That’s it! You have successfully installed and configured the Koha Library System on your server. If you encounter any issues or have questions, feel free to ask for assistance. Happy managing!

---