User:Victor Grousset - tuxayo/Test Koha package install

From Koha Wiki
Jump to navigation Jump to search

(In a Debian 9 docker container)


To have straightforward wait to test if the packages from the master branch install well and if the resulting Koha instance works.

Why docker

To quickly have an already installed Debian and boot fast and takes little resources. Which can be started over quickly. (useful for signoff or to try on various Debian versions or Koha versions)

At the expense of some common packages missing that will add some steps compared to a Debian install in a virtual machine or using remote server with a more standard Debian already installed.

Download the official Debian 9 image

docker pull debian:9

Start the container

docker run -d --name koha-install debian:9 sleep infinity

It's name will be "koha-install"

The container will continue running in the backgroud until you run the following:

stop the container

docker stop koha-install

Go into the container

docker exec -it koha-install /bin/bash

Add some packages due to minimal Debian image

apt update
apt install dialog apt-utils wget gpg sudo vim -y
  • sudo: to directly be able to paste commands from the installation instruction
  • vim: personal convenience

Install Koha

Follow the install instructions until the part listed in the next section. Mainly because this is an install of the master version of Koha instead of the released ones.

Until "Set up package sources"

The whole section can be replaced by this one. So ignore (or just read):

  • Set up package sources
  • Pick which Koha version to follow
  • Follow a suite: stable, oldstable …
  • Follow a codename (version number): 19.11, 19.05, 18.11
Actual work
echo "deb unstable main" > /etc/apt/sources.list.d/koha.list
wget -O- | apt-key add -

echo "deb [trusted=yes] dev main" >> /etc/apt/sources.list.d/koha.list
# ↑ No need for GPG keys, the packages aren't signed as of now.
apt update

Now go back on track with "Install Koha "

Until "Install the database"

Additional step: start MariaDB

service mysql start

Until "Configure the defaults"

Lazy way, don't setup a domain for Koha, as it's just to test a package install.

Just get rid of the warning.

# Get rid of Apache warnings
echo "ServerName kohadevdock"       >> /etc/apache2/apache2.conf