Koha Installation
Koha 24.05 · Ubuntu 22.04
Overview
Koha is an open-source integrated library system for cataloguing, circulation and managing library collections.
01System Preparation
sudo apt updateRefreshes the local package index using configured repositories.
sudo apt upgradeUpgrades installed packages; review changes before proceeding.
02Install a Text Editor
sudo apt -y install mousepadInstalls the named packages and their dependencies.
03Configure Koha Repository
Two source alternatives appear in the original; “OR” separates them. Do not execute both without checking repository compatibility.
echo deb http://debian.koha-community.org/koha stable main | sudo tee /etc/apt/sources.list.d/koha.listOriginal installation command or configuration value. Follow the surrounding steps for correct context.
Legacy or security-sensitive instruction — verify compatibility before execution.
wget -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -Imports an APT signing key using a deprecated method. Refer to current upstream documentation before running.
Legacy or security-sensitive instruction — verify compatibility before execution.
sudo apt updateRefreshes the local package index using configured repositories.
sudo apt upgradeUpgrades installed packages; review changes before proceeding.
sudo apt cleanRuns the original operation with administrator privileges; confirm paths and version requirements.
echo deb http://debian.koha-community.org/koha oldstable main | sudo tee /etc/apt/sources.list.d/koha.listOriginal installation command or configuration value. Follow the surrounding steps for correct context.
Legacy or security-sensitive instruction — verify compatibility before execution.
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add –Imports an APT signing key using a deprecated method. Refer to current upstream documentation before running.
Legacy or security-sensitive instruction — verify compatibility before execution.
sudo apt updateRefreshes the local package index using configured repositories.
sudo apt upgradeUpgrades installed packages; review changes before proceeding.
sudo apt cleanRuns the original operation with administrator privileges; confirm paths and version requirements.
04Install Required Software
MySQL and MariaDB are original alternatives. A password placeholder appears in the source.
sudo apt install koha-commonInstalls the named packages and their dependencies.
sudo apt install mysql-serverInstalls the named packages and their dependencies.
sudo apt install -y mariadb-serverInstalls the named packages and their dependencies.
sudo mysqladmin -u root password newpass [Replace 'newpass']Runs the original operation with administrator privileges; confirm paths and version requirements.
Legacy or security-sensitive instruction — verify compatibility before execution.
sudo apt install -y koha-commonInstalls the named packages and their dependencies.
05Configure Koha
sudo mousepad /etc/koha/koha-sites.confOpens a file in an editor for manual configuration.
INTRAPORT="8080"Original installation command or configuration value. Follow the surrounding steps for correct context.
06Create Library Instance
sudo a2enmod rewriteRuns the original operation with administrator privileges; confirm paths and version requirements.
sudo a2enmod cgiRuns the original operation with administrator privileges; confirm paths and version requirements.
sudo service apache2 restartManages or checks a system service.
sudo koha-create --create-db libraryCreates the named Koha library instance.
07Configure Web Server
sudo mousepad /etc/apache2/ports.confOpens a file in an editor for manual configuration.
Listen 8080Original installation command or configuration value. Follow the surrounding steps for correct context.
Listen 8081Original installation command or configuration value. Follow the surrounding steps for correct context.
sudo service apache2 restartManages or checks a system service.
sudo a2dissite 000-defaultRuns the original operation with administrator privileges; confirm paths and version requirements.
sudo a2enmod deflateRuns the original operation with administrator privileges; confirm paths and version requirements.
sudo a2ensite libraryRuns the original operation with administrator privileges; confirm paths and version requirements.
sudo service apache2 restartManages or checks a system service.
08Access Koha
sudo service memcached restartManages or checks a system service.
http://127.0.1.1:8080A URL in the original guide, not a shell command.
Legacy or security-sensitive instruction — verify compatibility before execution.
sudo mousepad /etc/koha/sites/library/koha-conf.xmlOpens a file in an editor for manual configuration.
About & Official Resources
Koha is an open-source integrated library system for cataloguing, circulation and managing library collections.