Install Koha On Windows Through Virtual box

Koha is an open-source library management system with many advanced features. it is fully customizable. The software is supported by international standards like MARC21, Z39.50, RFID, etc. 

Koha can install it on Linux operating system only. Before installing koha, we need to install any open-source Linux operating system like Ubuntu, Debian, Linux Mint, etc. We can install it on a virtual machine or directly on a physical machine. Follow the below steps in order to install Ubuntu and koha on your machine


Download and install Virtual-box on your windows operating system.


(Ignore both the steps if you have already installed Ubuntu on a virtual machine or on your physical machine)


Open Terminal 

Applications > System Tools > Terminal or (ctrl+alt+t) 

sudo su

Enter the user password 

Update and upgrade the ubuntu with the following commands

sudo apt update

sudo apt upgrade

Run the following commands to Add Koha Community Repository & Trusted Repository Key 

echo deb stable main | sudo tee /etc/apt/sources.list.d/koha.list

Add the key in gpg.asc to your APT trusted keys

wget -O- | sudo apt-key add -

Now update the repository with the below command

sudo apt update

Install koha software

sudo apt install koha-common

Install database server (MariaDB server)

sudo apt-get install -y mariadb-server

(Enter the password while the system asks for the password during the installation process. If the password window does not appear during the installation server then apply the following command in order to secure the password)

sudo mysql_secure_installation

It is recommended answer no (N) for the first question for changing the root password and answer yes (Y) for all remaining questions.

Install  text gedit text editor 

sudo apt -y install gedit

Port Configuration

Open the following file with the editor and Change the port number

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

Change the port number for the Koha staff client from 80 to 8001


Save and close the file

Run the following commands one by one in order to enable rewrite and CGI

sudo a2enmod rewrite

sudo a2enmod cgi

Restart Apache

sudo service apache2 restart

Create a Koha instance  (“library” is the instance name)

sudo koha-create --create-db library

Assigned port number 8001 for Koha staff client

sudo gedit /etc/apache2/ports.conf

Add port number 8001 below "Listen 80"

Listen 80
Listen 8001

It will look like the below screen:-

Restart Apache

sudo service apache2 restart

Run the following commands to enable the apache modules and virtual host

sudo a2dissite 000-default
sudo a2enmod deflate
sudo a2ensite library

Restart Apache Again

sudo service apache2 restart

Run the following command to install “Locale:: Language” Perl

sudo apt install liblocate-codes-perl

Enable and start Plack for performance improvement (Enable only if your machine has sufficient RAM)

sudo koha-plack --enable library

sudo koha-plack --start library

Install Perl modules

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

Configure Koha

Open a web browser and log in to the web installer

http://localhost:8001 or

username: koha_library 

Password: apply the following command to get a password

sudo koha-passwd library

Enter the username and password and follow the further instructions for the koha configuration. Next Complete the installation process by creating the library, super librarian account, item type, etc.

URL for Koha OPAC:-  http://localhost or


1 comment:

  1. At the end of the command I see the new command of pearl which is very useful. Thanks sir


Powered by Blogger.