Installing Koha Presented By Aaron R. Williams KOHA North American Users Group

About Me Works as a Web Developer at Mercyhurst University – Responsible for the main website – Full stack developer. – Linux experience. Installing and maintaining various software stacks. (Apache MySQL PERL PHP) – Polyglot

Installing Koha - Overview Koha minimum hardware requirements. – It Works On A Raspberry Pi(Runs Slow) 700mhz ARM processor 512mb’s of Memory 3.5 watts of power SD card storage. – Better hardware recommended for speed.

Installing Koha - Overview Koha minimum software requirements – Linux OS Usually Debian or Ubuntu but other Linux distribution are supported. – Apache web server – MySQL – PERL Programming language Lots of Perl dependencies.

Installing Koha – Overview Installation Methods – From Source/Git – Apt-get and pre-built packages

Installing Koha Installing the pre-built virtual machines on VirtualBox

Installing Koha Instructions for installing on Ubuntu or Debian – Add community repository echo deb stable main | sudo tee /etc/apt/sources.list.d/koha.listhttp://debian.koha-community.org/koha – Add trusted repository key wget -O- community.org/koha/gpg.asc | sudo apt-key add – community.org/koha/gpg.asc – Update Ubuntu or Debian using apt-get sudo apt-get update sudo apt-get upgrade

Installing Koha Instructions for installing on Ubuntu or Debian – Clear the apt-get package manager cache sudo apt-get clean – Install Koha and dependencies sudo apt-get install koha-common – Problem with Apache itk(errors on install – usually happens) sudo a2dismod mpm_event sudo a2enmod mpm_prefork sudo service apache2 restart sudo apt-get install -f

Installing Koha Instructions for installing on Ubuntu or Debian – Edit initial configuration file sudo nano /etc/koha/koha-sites.conf Edit intraport, opacport, domain, and memcache settings depending on install – Install mysql-server dependency sudo apt-get install mysql-server – Ensure rewrite and cgi are enabled sudo a2enmod rewrite && sudo a2enmod cgi && sudo service apache2 restart

Installing Koha Instructions for installing on Ubuntu or Debian – Setup the database for Koha sudo koha-create --create-db library – Secure mysql installation(follow onscreen wizard) sudo mysql_secure_installation – Add new 8080 port (for IP based installation) to Apache sudo nano /etc/apache2/ports.conf Add Listen 8080 (right below Listen 80)

Installing Koha Instructions for installing on Ubuntu or Debian – Enable vhost on Apache sudo a2enmod deflate && sudo a2ensite library && sudo service apache2 restart – Test to ensure everything is working Visit localhost or Visit localhost:8080 or :8080

Installing Koha Instructions for installing on Ubuntu or Debian – Visiting localhost:8080 or :8080 Should prompt for username or password username -> koha_library password -> sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/library/koha- conf.xml Follow onscreen setup instructions/wizard

Installing Koha Resources – community.org/wiki/Koha_on_ubuntu_- _packages community.org/wiki/Koha_on_ubuntu_- _packages

Installing Koha Questions?