Installing Koha: Configure the installer and install koha

  1. Installing Koha : Introduction
  2. Installing Koha: Create a User Account on Debian
  3. Installing Koha: Update Debian packages
  4. Installing Koha: Download koha and install required packages
  5. Installing koha: Create MySQL database
  6. Installing Koha: Configure the installer and install koha
  7. Installing Koha: Configure apache2 web server and run koha web installer
  8. Installing Koha: Configure and start Zebra

Before you can install koha, you need to provide some information to the installer. Run the following command to configure the installer

perl Makefile.PL

You will be asked very many questions but you only need to answer a few.
For default values, just press enter. No need to retype
For installation mode, press enter to select standard
For base installation directory, press enter to select the default as well
For user account, type in user1 (or the user you created during step 2)
For group type in user1 (like above)
For DBMS to use press enter to select the default MySQL
For database server press enter to select the default localhost
For the port number to be used by DBMS, press enter to select the default 3306
For the name of the database to be used by koha, type in koha_db
For the user that owns the database, type in root
For the password for the database user, type in the password you provided in step 4

For the remaining questions, press enter until the end to use the default values.

Next, build koha using the following command


It will start copying A LOT of files
When it finishes, test koha by running the following command

make test

When it is finished, look for Result: PASS. If it fails, try running the command again.

The final step in this section is to actually install koha. Run the command below to install koha

sudo make install

Pay attention to the fact that we are using sudo because the installer requires administrator privileges to copy koha’s files to the system folders. Most of the files will be copied to /usr/share/koha and configuration files will be copied to /etc/koha

Finally, open the file /etc/profile and append the following lines to the end of the file


Save and close the file then execute this command

. /etc/profile

The above command will make the two variables available to the system environment and this will be useful in the next sections when you will be setting up cronjobs.

Otuoma Sanya

Otuoma Sanya is a full-time systems librarian, tech enthusiast and writer. His areas of interest are data mining, institutional repositories, library automation and web development using python Django.

Leave a Reply