This repo is no longer maintained by Deichman (Oslo Public Library)
If anyone wants to keep on developing this, we'd happily transfer ownership.
If interested in seeing our customized version of the Koha project, head to OPL repo.
It includes a koha + mysql setup with a heavily customized version of Koha, of course keeping the GPL license.
This project builds a Docker image containg an installation of the library system Koha.
More documentation can be found on project wiki
This is documentation on the development setup used in Deichman, but should be general enough to be used by anyone.
https://github.com/Koha-Community/Koha (upstream) the community code
git clone https://gitlab.deichman.no/digibib/koha
We keep master in sync with upstream and a local branch for each release with all our local patches on top (eg. release_17.11.01)
git checkout release_17.11.01
https://gitlab.deichman.no/digibib/koha (origin) deichman fork with local patches
This is the project for setting up Koha using docker in the various environments:
git clone https://gitlab.deichman.no/digibib/koha-docker
TODO: use Makefile instead
KOHAPATH must point to koha-docker root dir
source docker-compose.env && KOHAPATH=.. docker-compose -f common.yml -f dev.yml build koha_dev
KOHAPATH must point to koha-docker root dir
REPO must point to koha code repo
source docker-compose.env && KOHAPATH=.. \
docker-compose -f common.yml -f dev.yml run --rm --volume=/home/to/koha/repo:/kohadev/kohaclone --publish=8081:8081 koha_dev
Container will have an autogenerated name (find it with docker ps
) if not started with --name
Admin pages are at localhost:8081, with default admin (admin/secret) login
docker exec -it dockercompose_koha_dev_run_1 bash
It is a debian jessie distro, koha source code is mounted in /kohadev/kohaclone
A lot of env vars exist used to configure system (use env
for overview)
restart service
supervisorctl -u$KOHA_ADMINUSER -p$KOHA_ADMINPASS restart <service> <service>
plack ( perl multiworker server, need to be restarted for koha to pick up changes in modules, systempreferences etc )
sip ( sip server used by self checkout machines, door access, etc )
ncip_server ( interlibrary loan NCIP service )
zebra_server ( local Koha search index )
enter mysql
koha-mysql name
Koha xml configuration file
KOHA_CONF=/etc/koha/sites/name/koha-conf.xml
run tests ( from /kohadev/kohaclone )
KOHA_CONF=/etc/koha/sites/name/koha-conf.xml PERL5LIB=. perl t/db_dependent/api/v1/illrequests.t