Este documento proporciona instrucciones para instalar el software de biblioteca Koha en Ubuntu 16.04 o superior. Describe cómo actualizar el sistema, instalar dependencias como MariaDB, Apache, PHP y herramientas de descompresión, configurar la base de datos, instalar Koha y sus módulos de Perl, y configurar Apache para ejecutar la instancia de Koha.

1. Supuestos:
 Se cuenta con un equipo, virtual o físico con Ubuntu 16.04 o superior.
 El equipo reúne los requisitos mínimos de instalación de Koha.
 El usuario tiene permisos de superusuario
 Las líneas en este color se ejecutan una por una.
Actualizar sistema
sudo apt-get update
sudo apt-get safe-upgrade
Instalar herramientas de descompresión de archivos:
sudo apt-get install rar unace p7zip p7zip-full p7zip-rar unrar
Instalar MariaDB
sudo apt-get install mariadb-server mariadb-client
--Durante la instalación pedirá una contraseña, esa guardarla bien!
sudo systemctl start mariadb
sudo systemctl status mariadb
 Escribir contraseña para el usuario root de MySQL y guardar.
mysql_secure_installation
- Set root password? [Y/n] y
- Remove anonymous users? [Y/n] y
- Disallow root login remotely? [Y/n] y
- Remove test database and access to it? [Y/n] y
- Reload privilege tables now? [Y/n] y
Para verificar:
sudo mysql -u root -p
Instalar apache:
sudo apt-get install apache2

2. Instalar PHP (No es indispensable)
sudo apt-get -y install php7.0 libapache2-mod-php7.0
Reiniciar apache:
sudo service apache2 restart
Soporte para PHP y base de datos (sólo si instalo php y hará desarrollos en php):
sudo apt-cache search php7.0
sudo apt-get -y install php7.0-mysql php7.0-curl php7.0-gd php7.0-intl
php-pear php-imagick php7.0-imap php7.0-mcrypt php-
memcache php7.0-pspell php7.0-recode php7.0-sqlite3 php7.0-tidy
php7.0-xmlrpc php7.0-xsl php7.0-mbstring php-gettext
Reiniciar apache:
sudo service apache2 restart
Habilitar SSL en Apache:
sudo a2enmod ssl
sudo a2ensite default-ssl
sudo systemctl restart apache2
En caso que requiera administrar la base de MySql desde una interfaz gráfica puede
instalar PhpMyAdmin con el siguiente comando:
sudo apt-get install phpmyadmin
Se instala el make para compilar los módulos perl que hagan falta:
sudo apt-get install make
Editar archivo de fuentes de los paquetes de koha:
sudo nano /etc/apt/sources.list.d/koha.list
Añadir la siguiente linea:
deb http://debian.koha-community.org/koha stable main
Guardar presionando la tecla control y la O y luego control y X

3. Ejecutar:
wget -q -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-
key add -
Actualizar el sistema:
sudo apt-get update
Instalar koha-common
sudo apt-get install memcached
sudo apt-get install koha-common
sudo nano /etc/koha/koha-sites.conf
Si no tiene un dominio asociado a su equipo:
EN EL OPAC DEJAR PUERTO 80
EN LA INTRANET DEJAR PUERTO 8080
Si require manejar sus DNS en la instalación de Koha por favor lea antes:
http://wiki.koha-community.org/wiki/Koha_3.x_on_Debian_Squeeze#Quick_Start
En caso contrario continúe con las indicaciones.
Actualizar apache:
sudo a2enmod rewrite
sudo a2enmod cgi
sudo service apache2 restart
Crear nueva instancia de Koha
sudo koha-create --create-db --marcflavor marc21 --zebralang es --use-
memcached demokoha
*En este Ejemplo la instancia se llama demokoha

4. Para traducir koha al español, ir a la ruta:
cd /usr/share/koha/misc/translator
Ejecutar la instrucción:
sudo koha-translate --install es-ES
Abrir puertos en apache:
sudo nano /etc/apache2/ports.conf
SOLO SI ES NECESARIO AGREGAR EL PUERTO 8080 debajo de donde dice
Listen 80 poner Listen 8080
Guardar con control y O y luego presionar control y X
Se añaden los puertos que se requiera, se guardan los cambios, se cierra el archivo,
se reinicia apache con la instrucción:
sudo service apache2 restart
Deshabilitar sitio por defecto:
sudo a2dissite 000-default.conf
sudo a2enmod deflate
sudo a2ensite demokoha
sudo service apache2 restart
Si se quieren cambiar los puertos de salida de la intranet y el opac se edita:
sudo nano /etc/apache2/sites-available/demokoha.conf
** Reiniciar apache si se han cambiado los puertos por defecto.
Si se deja como esta por defecto se abre la siguiente dirección en un navegador:

5. http://IP:8080
Donde IP es la IP o dominio de su servidor.
Si entra desde otro PC verificar cual es la IP del equipo donde se instaló Koha.
En el archivo:
sudo nano /etc/koha/sites/demokoha/koha-conf.xml
Se buscan los datos del usuario creado en la sección base de datos, que es el
superadministrador de Koha:
Se encuentran casi al final del archivo.
Ejemplo:
<database>koha_demokoha</database>
<hostname>localhost</hostname>
<port>3306</port>
<user>koha_demokoha</user>
<pass>toc4pnRFOfIyBzKX</pass>
Se siguen los pasos que muestra el instalador web, al volver a iniciar sesión lo
primero es verificar que todos los módulos de perl están instalados:
Koha --> Acerca de koha --> Módulos perl
Si hace falta instalar algun paquete se ejecuta:
perl -MCPAN -e shell
La primera vez se ejecuta:
o conf init

6. Para instalar los módulos faltantes:
Ejemplos:
install Business::ISBN
install HTTPD::Bench::ApacheBench
install Readonly::XS
install Test::DBIx::Class
Todos los que hagan falta.
Al terminar se ingresa el comando:
Exit
Actualizar sistema y repositorios:
sudo apt-get update && sudo apt-get upgrade
Revisamos de Nuevo la ruta:
Koha --> Acerca de koha --> Módulos perl
Y todos los módulos deberán mostrarse en negro.
Para permitir que los usuarios seleccionen si quieren ver la interfaz en español o en
inglés se debe entrar a la ruta:
Administración  Global System preferences  I18N/L10N
Y seleccionar las casillas correspondientes.
Con la instalación el indexado de la base de datos se correrá de manera automática
cada 15 minutos, si se requiere reindexar zebra se realiza con el siguiente comando:
koha-rebuild-zebra -f -v demokoha
Realizado con información de las siguientes direcciones:
Koha 3.x on Debian Squeeze
http://wiki.koha-community.org/wiki/Koha_3.x_on_Debian_Squeeze

7. Comandos proporcionados por los paquetes Debian
http://wiki.koha-
community.org/wiki/Comandos_proporcionados_por_los_paquetes_Debian#koha-
list