Source: (http://wiki.koha-community.org/wiki/Koha_3.8_on_Debian_Squeeze)
There is an APT package repository for Debian packages of Koha, and those of its dependencies that are missing from Debian. The Debian squeeze release is supported; older versions of Debian are not supported.
This is instruction for installing the 'koha-common' package only.
1. Access your root SSH
2. To get the stable 3.8 release, add this to a /etc/apt/sources.list.d/koha.list file:
deb http://debian.koha-community.org/koha squeeze main
3. Add the key in gpg.asc to your APT trusted keys:
If you do not have sudo please run:
# apt-get install sudo
and then (care for capital O)
# wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -
4. After that, you should be able to install Koha:
apt-get update
apt-get install koha-common (!! see below !!)
less /usr/share/doc/koha-common/README.Debian (!! or less /usr/share/doc/koha/README.Debian !!)
Read the README.Debian file for instructions on how to configure Koha after the package is installed.
Wait! There are actually two packages here: koha and koha-common.
Quick Start
This assumes that you are using the koha-common package.
To configure your server for use with DNS names: After install, edit /etc/koha/koha-sites.conf with details about your site. You may need to create this file. Some example content would be:
DOMAIN=".MyUniversity.org" # Any library instance will be a subdomain of this string.
INTRAPORT="8080" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="admin" # For administration interface URL: Suffix to be added to the instance name.
DEFAULTSQL="" # only needed if you're pre-populating from another Koha database
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="marc21" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'
ZEBRA_LANGUAGE="en" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'
Please use port 8080 as Plesk uses the default 80 for all its real domain and it will not work for virtual domain of KOHA.
6. Next, you will need to enable the Apache mod_rewrite module:
sudo a2enmod rewrite
If you're planning to run MySQL on a separate server, please do not run koha-create --create-db instancename as mentioned below.
Instead, see Install Koha 3.6 on Debian squeeze using a separate MySQL server.
Now you need to create your first koha instance. Replace instancename with the name of your library. If you want to have library.example.com, then instancename can probably be "library".
sudo koha-create --create-db library
Now you can visit your administration website to continue with the Koha web installer.
The username to log in with will be koha_instancename and the password will be near the end of /etc/koha/sites/instancename/koha-conf.xml. You will need to be root to view this You could also use this command:
sudo xmlstarlet sel -t -v 'yazgfs/config/pass'
/etc/koha/sites/instancename/koha-conf.xml
to print it out.
Commands to build a language for interface (example for france french):
/usr/share/koha/misc/translator
sudo env PERL5LIB=/usr/share/koha/lib/ KOHA_CONF=/etc/koha/sites/instancename/koha-conf.xml perl translate install fr-FR
Commands to build all available languages for interface:
/usr/share/koha/misc/translator
Langs="$(ls -1 /usr/share/koha/misc/translator/po/ | grep -ie "pref.po" | sed -e "s/-pref\.po//g")"
for Current in $Langs ; do sudo env PERL5LIB=/usr/share/koha/lib/ KOHA_CONF=/etc/koha/sites/instancename/koha-conf.xml perl translate install $Current ; done
9. Get Koha to appear on Plesk Naked domain
Firstly, We create a server domain in plesk, eg: library.MyUniversity.org Secondly:
Edit the vhost.conf
/var/www/vhosts/library.MyUniversity.org/conf/vhost.conf
and add the following contents:
Code to be added to your vhost.conf:
SSLProxyEngine on
ProxyRequests off
ProxyPass / http://library.MyUniversity.org:8080/
ProxyPassReverse / http://library.MyUniversity.org:8080/
10. then finally:
For Plesk 11.*
# /usr/local/psa/admin/sbin/httpdmng --reconfigure-all
If you get an error message here, that means you need to enable some proxy module in your Apache, you can do this by going to your Plesk panel
Home > Tools & Settings > Apache Modules
and enable the proxy modules.
now you can try opening:
http://library.MyUniversity.org
11. Importing data and indexing Zebra db
run command
# koha-start-zebra library
and then
# sudo koha-rebuild-zebra --full -v
12. Change the default KOHA logo to MYUniversity.org logo
Please follow the instructions at:
http://www.myacpl.org/koha/?p=3
You will find required files in
/usr/share/koha/opac/htdocs/opac-tmpl/bootstrap/images
Koha Customization
YourDomain.org/cgi-bin/koha/admin/preferences.pl?tab=opac
Most of your OPAC customization can be done through the system preferences for the OPAC. But also need to know simple HTML in order to make many of the items work o More
Go to
admin site > Administration > Global System Preferences > OPAC
Then click Appearance
Take backup of your existing Koha database.
http://kohageek.blogspot.co.uk/2015/08/move-old-koha-database-to-new.html
Or you can use Koha-Dump
https://github.com/Koha-Community/Koha/blob/master/debian/scripts/koha-dump
This one works great
Run this
# sudo mysql -u koha_library -p koha_library < koha_library_old3.10
Enter password: (this is the password generated in the new koha-conf.xml file
Plesk source
https://talk.plesk.com/threads/installing-koha-on-debian-6-with-plesk-11.262253/
Arabic Indexing,
https://wiki.koha-community.org/wiki/How_to_add_new_zebra_index
Point 8 is unclear for Koha 16.05
/usr/share/koha/opac/htdocs/opac-tmpl/bootstrap/en/modules
Installing Koha on a VPS/Dedicated Server (Info here)
# If there is no mySQL server available on your server, The run this to install it
Set up Apache
Create a Koha instance
Enable the Site and Apache Mods
Configure Koha from the Web
The Username is koha_ [INSTANCE NAME]. Now enter following command in your browser: