Installing koha on Debian-lenny

I have written it from my practical experience

log on as a root uer

Edit your /etc/apt/sources.list file and add the following:

# Index Data
deb lenny main
deb-src lenny main

localhost:~#apt-key add indexdata.asc

Download koha adn unzip it:


localhost:~#tar xvzf koha-3.00.06.tar.gz

localhost:~#cd root/koha-3.00.06

localhost:~/koha-3.00.03# apt-get update

open synaptic pakage manager and mark the following package for install


Edit koha-debian source package list

localhost:~/koha-3.00.06#gedit root/koha-3.00.03/install_misc/debian-lenny.packages

(In this file delete apache2 install, apache2-mpm-worker install, libdbd-mysql-perl install,
libdbd-mysql-perl install, libdbd-sqlite3-perl install, libdbi-perl install, mysql-server install )
related lines and save the file and then run the following commands. Since we have
separately installed those files through Synaptic we will not install those files through

Run the following command to select remaining packages

localhost:~/koha-3.00.06#dpkg –set-selections < install_misc/debian-lenny.packages

localhost:~/koha-3.00.06#sudo apt-get install dselect

localhost:~/koha-3.00.06# dselect

Choose [I]nstall and accept packages to be installed (hit return) (may take a while)
Choose [C]onfigure, [R]emove and [Q]uit until dselect has completed.
Say “yes” to delete any previously downloaded .deb files
Now there is need to download separately all PERL modules which are not installed by
command. Login again as root and on root type. If you are using CPAN for the first time it
will ask whether CPAN should configure as much as automatically say “yes” here and keep
pressing default values until the CPAN installation of each module is over where you will
see “make install ok” option.

Install missing perl module for koha through cpan:

localhost:~/koha-3.00.06#cpan Algorithm::CheckDigits Class::Adapter GD::Barcode
localhost:~/koha-3.00.06# cpan HTTP::OAI JSON Params::Util PDF::Reuse::Barcode
localhost:~/koha-3.00.06# cpan SMS::Send Storable Test::Simple GD Text::CSV
localhost:~/koha-3.00.06# cpan PDF::API2 HTML::Template::Pro Text::CSV_XS

Add user for koha:

localhost:~/koha-3.00.06#adduser koha
[It is essential only if you have not created koha
as a user while Debian Installation].

Make KOHA Environments:
localhost:~/koha-3.00.06#nano /etc/profile
(add the following lines in profile file at the end and save and exit)

export PERL5LIB=/usr/share/koha/lib
export KOHA_CONF=/etc/koha/koha-conf.xml

UTF-8 Encoding in Apache:-
localhost:~/build/koha-3.00.06# gedit /etc/apache/apache2.conf
(Add following three lines at the end of the file in apache2.conf and save and exit)
#UTF8 support for apache2
ServerName localhost
#[Here you should use your computer name i.c host name instead of“localhost”]
AddDefaultCharset UTF-8
AddCharset UTF-8 .utf8

UTF-8 Encoding in MySQL:
localhost:~/build/koha-3.00.03# gedit /etc/mysql/my.cnf
(open my.cnf file and add after the “Basic Setting” and after skip-external-locking line add
the following lines)
# UTF-8 Defaults for Koha
init-connect=”SET NAMES utf8”
localhost:~/koha-3.00.06# gedit /etc/apache2/ports.conf
(open ports.conf file and below Listen 80 add following line and save file and exit)
Listen 8080

Create Database for KOHA:

localhost:~/koha-3.00.06#mysql -u root -p
(Enter mysql root password)
mysql>create database koha;
mysql>grant all privileges on koha.* to ‘root’@’localhost’ identified by ‘password’;
mysql>flush previleges;

Now runfollowing commands to install Koha:

localhost:~/koha-3.00.06# perl Makefile.PL

(If installation process ends with any missing PERL modules, try to
install those missing modues from a terminal and tying cpan and module name and then
again try above perl Makefile.PL command.)

Here default values of Makefile.PL commnand

# Choose the following options:
Installation mode (dev, single, standard) [standard] = standard
Base installation directory [/usr/share/koha] = /usr/share/koha
User account [koha] = koha
Group [koha] = koha
DBMS to use (Pg, mysql) [mysql] = mysql
Database server [localhost] = localhost
Please specify the port used to connect to the DMBS [3306] = 3306
Please specify the name of the database to be used by Koha [koha] = koha
Please specify the user that owns the database to be used by Koha [kohaadmin] kohaadmin
NOTE:This user (kohaadmin) and password are both the MySQL login/pwd and the web
admin interface login/pwd.
Please specify the password of the user that owns the database to be used by Koha
= katikoan (or you can select the password as you wish)
Install the Zebra configuration files? (no, yes) [yes] = yes
MARC format for Zebra indexing (marc21, unimarc) [marc21] = marc21
Primary language for Zebra indexing (en, fr) [en]
Authorities indexing mode (dom, grs1) [grs1] = grs
Please specify Zebra database user [kohauser] = kohauser
Please specify the Zebra database password [zebrastripes] = zebrastripes [you can select
your own password here]
Install the SRU configuration files? (no, yes) [yes] = yes
SRU Database host? [localhost] = localhost
SRU port for bibliographic data? [9998] = 9998
SRU port for authority data? [9999] = 9999
Install the PazPar2 configuration files? [no] = no
Would you like to run the database-dependent test suite? (no, yes) [no] = no))))

localhost:~/koha-3.00.06~# make
localhost:~/koha-3.00.06~#make test
localhost:~/koha-3.00.06~#make install

Setting up Environmental Variables

localhost:~/koha-3.00.06# export KOHA_CONF=/etc/koha/koha-conf.xml
localhost:~/koha-3.00.06# export PERL5LIB=/usr/share/koha/lib

Configure Koha ,apache and zebra
localhost:~/koha-3.00.06#ln -s /etc/koha/koha-httpd.conf /etc/apache2/sites-available/koha
localhost:~/koha-3.00.06#sudo a2enmod rewrite
localhost:~/koha-3.00.06#sudo a2ensite koha
localhost:~/koha-3.00.06#sudo apache2ctl restart
localhost:~/koha-3.00.06# ln -s /usr/share/koha/bin/ /etc/init.d/koha-zebra-
localhost:~/koha-3.00.06# sudo update-rc.d koha-zebra-daemon defaults
localhost:~/koha-3.00.06# ln -s /usr/share/koha/bin/ /etc/init.d/koha-
localhost:~/koha-3.00.06#sudo update-rc.d koha-zebraqueue-daemon defaults


Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s