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

Step 5 - Create a 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 6 - 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

sudo a2dissite 000-default

• Disable the default koha website

sudo a2dissite koha

• Enable the custom "library" web site

sudo a2ensite library

• Restart the apache2 web server

sudo service apache2 restart

Step 7 - 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