Docker deployment for Koha Integrated Library System. Forked from https://github.com/teogramm/koha-docker
Find a file
2025-03-19 11:41:02 +01:00
examples Hardcode rabbitmq version in example compose file 2025-02-09 22:28:48 +01:00
files Add worker for long_tasks queue 2025-02-09 22:28:15 +01:00
config-main.env Fix Zebra server not starting 2023-02-18 13:14:43 +02:00
config-sip.env Initial commit 2023-02-11 20:54:40 +02:00
Dockerfile Update to Koha 24.11 2025-02-06 23:31:57 +01:00
LICENSE Initial commit 2023-02-11 20:54:40 +02:00
README.md Add information about initial setup 2025-03-19 11:41:02 +01:00

koha-docker

Docker Image Version (tag latest semver)

A Koha Docker container which includes:

  • The Apache webserver serving the OPAC (Port 8080) and the Koha staff interface (Port 8081), configured to use Plack.
  • The Zebra server and indexer.
  • The Koha background jobs worker.

A fully functional Koha instance additionally requires:

  • A MySQL/MariaDB server.
  • A Memcached server.
  • A RabbitMQ server with the stomp pulgin enabled.

Elasticsearch is also supported, instead of Zebra.

Notice: SIP and Z3950 are still WIP.

A separate RabbitMQ server with the stomp plugin is required as well as a Memcached server. Both can be easily created using the images available on Docker Hub.

Usage

The image is available on Docker Hub

The main configuration environment variables are documented in config-main.env.

The username and password for the initial setup are the same as the database username and password.

Logs for stored under the /var/log/koha directory.

In order to function, Koha requires a MySQL database, a Memcached server and a RabbitMQ server with the stomp plugin.

The provided docker-compose file sets up all of these as containers. It provides an easy way to get a Koha insstance up and running. For a production environment it is recommened that each container is set up separately.

Credits

Some scripts have been taken from https://gitlab.com/koha-community/docker/koha-docker and modified.