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
echo deb http://debian.koha-community.org/koha squeeze main | sudo tee /etc/apt/sources.list.d/koha.list
 * After installation add the following to /etc/apt/sources.list.d/koha.list.

wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add - sudo apt-get update
 * Do a software upgrade.

sudo apt-get dist-upgrade

Step 4 - Install Koha packages
sudo apt-get install koha koha-common bibutils etckeeper
 * Install the koha packages

Step 5 - Initial configuration
Read the after installation README file for details. cat /usr/share/doc/koha/README.Debian | less

Step 6 - Prepare the Apache2 web server
sudo a2enmod rewrite suexec deflate
 * Setup apache2 modules

sudo a2dissite 000-default default default-ssl
 * Disable the default websites.

The only web site enabled should be koha in the /etc/apache2/sites-enabled folder. sudo service apache2 restart
 * Restart the apache2 web server

Step 7 - Do the Koha web installation
http://name-of-koha-server:8080 The user name to log in with will be koha and the password will be near the end of /etc/koha/koha-conf.xml
 * Reboot the server and then connect to the following URL to configure the KOHA webapp.

To view the password, use this command: sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/koha-conf.xml

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





















Return to Koha wiki page