How to Install Koha 26.05 on Ubuntu 26.04 LTS (Resolute Raccoon)!

 

  

 Koha is an open source Integrated Library System (ILS) used world wide by different libraries such as school, college, university special library etc. It was created in 1999 by Katipo Communications for the Horowhenua Library Trust in New Zealand. It was written in PERL and released under GNU General Public License V3 or later.

The stable version 26.05 released. To install koha 26.05 completely in Ubuntu 26.04 LTS Resolute Raccoon, we have to go through two processes i.e Charater User Interface installation (using terminal) and Graphical User Interface installation (using a web brower). Here the character user interface installation process discussed below.

Open Terminal by pressing Ctrl + Alt + T (Press at a time)

Step : 1 - Log in as superuser

sudo su

Enter root password

Step : 2 - Update the system

apt-get update

Step : 3 - Upgrade the system

apt-get upgrade

 

 

 

 
step : 4 - Install MySQL server

sudo apt-get install mysql-server

 

Step : 5 - Check MySQL version

mysql --version  

 

 

Step : 6 - Log in to MySQl

mysql -u root -p

Step : 7 - Set required permission

SET GLOBAL sql_mode='';

Next exit

Exit;


Step : 8 - Update again the system

apt-get update
apt-get upgrade

 

 


Step : 9 - Add Koha community repository

echo "deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha stable main" | sudo tee /etc/apt/sources.list.d/koha.list

 

 

 

 

sudo sh -c 'wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg'

 

 

Step : 10 - Update again the system

 

apt-get update
apt-get upgrade

 

 

Step : 11 - Install PERL dependencies

While installing koha 26.05 version on Ubuntu 26.04 Resolute Raccoon, sometimes during web installation process, Perl Module Missing error occurs. Basically shows, "Locale :: Language" is module missing. So, if this type of error occurs then we have to install required perl modules before executing koha-common. After bringing all required PERL modules we can make error free installation of Koha. Type below command in terminal-

 

perl -MCPAN -e 'install Bundle::KohaSupport'

 

Step : 12 - Install Koha

apt-get install koha-common 

 

 

Step : 13 - Configure koha sites

sudo gedit /etc/koha/koha-sites.conf

 

 

 

 

Here I change port number of Koha staff client to 8001. Find following line in the file and make changes.

INTRAPORT="8001"
OPACPORT="8002"

 

 

next save and quit.

Step : 14 - Create Apache configuration files.

sudo a2enmod rewrite
sudo a2enmod cgi
sudo service apache2 restart

Step : 15 - Create a Koha instance with the name library

sudo koha-create --create-db library


Step : 16 - Ubuntu MySQL security Tweak

sudo mysql_secure_installation

[Enter the MySQL Root password]

Give the answer n (no) for the first question. Give Y (Yes) for other questions. For detail instruction click here
 

 If  Problem occurs related to password

Then apply below commands one by one in another terminal window

sudo killall -9 mysql_sucure_installation

sudo mysql

ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'SetRootPasswordHere';

 

Next run the secure installation command 

Step : 17 - Adding ports

We have assigned 8001 port for Koha staff client and 8002 for OPAC.
Open following file and add new port.

sudo gedit /etc/apache2/ports.conf

Copy paste following line below Listen 80

Listen 8001
Listen 8002

 

 

next save and close the fie.

Step : 18 - Restart Apache

sudo service apache2 restart

Step : 19 - Enable modules and sites

sudo a2dissite 000-default
sudo a2enmod deflate
sudo a2ensite library
sudo service apache2 restart

Step : 20 - Zebra rebuild command

koha-rebuild-zebra -v -f library

Step : 21 - See the password in koha configuaration file

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

Step : 22 - Change the password of koha_library database

sudo gedit /etc/koha/sites/library/koha-conf.xml

Step : 23 - Configure MySQL for koha

sudo su

[enter the Linux Root password]

mysql -u root -p 

[enter the MySQL Root password]

use mysql;

ALTER USER 'koha_library'@'localhost' IDENTIFIED WITH mysql_native_password BY 'library';

 

If it will not work then we have to change some configuration because This error occurs because MySQL 8.4 LTS disables the legacy mysql_native_password plugin by default, and MySQL 9.0 removes it entirely. follow the below steps:

 

SELECT user, host, plugin FROM mysql.user WHERE plugin='mysql_native_password';
 

 

ALTER USER 'koha_library'@'localhost' IDENTIFIED WITH caching_sha2_password BY 'library';
 

 

FLUSH PRIVILEGES;

  

Now , it will work  properly!

quit;

Step : 24 - Restart memcached

sudo service memcached restart

Now, koha has been installed successfully

Step : 25 - Launch a web browser and put the following URL

http://127.0.1.1:8001 (Staff client)
http://127.0.1.1:8002 (Online catalogue)


Step : 26 - Web Installation

For web installtion instructions click here

 

 

Information Courtesy : 

1. https://en.wikipedia.org/wiki/Koha_(software)

2. https://koha-community.org/manual/latest/en/html/installation.html#