Koha/Installation

Introduction

It is strongly recommended that you use the "packages" installation method which is designed to simplify and streamline the installation, configuration and upgrades of Koha.

Step 1 - Install Ubuntu 12.04 LTS server software on a bare metal or virtual machine.

• During installation create a "koha" admin user.

Step 2 - Install the LAMP stack

• During installation install the "LAMP" stack.
• See: http://www.ubuntugeek.com/step-by-step-ubuntu-12-04-precise-lamp-server-setup.html

Step 3 - Enable the Koha software repository

• After installation add the following to /etc/apt/sources.list.d/koha.list.

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

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

• Do a software upgrade.

sudo apt-get update

sudo apt-get dist-upgrade

Step 4 - Install Koha packages

• Install the koha packages

sudo apt-get install koha koha-common bibutils etckeeper

Step 5 - Initial configuration

To configure your server for use, edit /etc/koha/koha-sites.conf with details about your site. You may need to create this file.

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

Some example content would be:

KOHASITE="SULIS OPAC" # Change this to the name of your site
OPACPORT="80"  # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
INTRAPORT="8080"  # TCP listening port for the administration interface
UNIXUSER="koha" # Name of unix user
UNIXGROUP="koha" # Name of unix group

Step 6 - Create a "single" Koha library instance

• Create a koha library database

sudo koha-create --create-db library

• Enable email for the "library" instance

sudo koha-email-enable library

Step 7 - Prepare the Apache2 web server

• Setup web server listening ports.

sudo nano /etc/apache2/ports.conf

Check the following for an example of listening ports

#NameVirtualHost *:80
Listen 80
Listen 8080

• Setup apache2 modules

sudo a2enmod rewrite

sudo a2enmod deflate

• Disable the default website. Remember to disable this after a software upgrade when using the packages method.

sudo a2dissite 000-default

• Disable the default koha website. Remember to disable this after a software upgrade when using the packages method.

sudo a2dissite koha

• Enable the custom "library" web site.

sudo a2ensite library

• Restart the apache2 web server

sudo service apache2 restart

Step 8 - Do the Koha web installation

• Reboot the server and then connect to the following URL to configure the KOHA webapp.

http://name-of-koha-server:8080

The user name to log in with will be koha_library and the password will be near the end of /etc/koha/sites/library/koha-conf.xml

To view the password, use this command:

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

Click on one of the screenshots below to view webapp config.

Return to Koha wiki page