Prerequisites and Installation
We recommend setup with docker-compose and Makefile for simplest possible use.
- Docker (installed automatically on Linux running
make provision(for osx or windows you need to install manually)
- Docker-compose (optional, but highly recommended. On Linux, same as above)
- Make (optional, recommended for simple build/setup/development commands)
On Linux you would simply do
make provision to setup system with docker-compose, docker and pulling docker
images and setting up containers and data volumes. For overriding any variables, simply put them in a file:
make help will give overview of make targets
make provision will pull / build the necessary images and start containers.
All relevant files are in folder
Basic setup with NO customizations would require:
source docker-compose.env && docker-compose -f common.yml -f build.yml up -d
docker-compose.env (base environment variables) KOHA_BUILD, KOHA_VERSION, KOHA_IMAGE_TAG, GITREF
Using Docker only
A plain startup with NO customisations:
docker run -d --name koha_docker \ --cap-add=DAC_READ_SEARCH --cap-add=SYS_NICE --cap-add=MKNOD \ -p 6001:6001 -p 8080:8080 -p 8081:8081 \ -e KOHA_INSTANCE=name \ -e KOHA_ADMINUSER=admin \ -e KOHA_ADMINPASS=secret \ -t digibib/koha
Please note that a lot of features will not work out of the box. (Email, SMS).