|
|
# Prerequisites and Installation
|
|
|
|
|
|
We recommend setup with docker-compose and Makefile for simplest possible use.
|
|
|
|
|
|
Tools needed:
|
|
|
|
|
|
* 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)
|
|
|
|
|
|
## Using Makefile
|
|
|
|
|
|
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:
|
|
|
`docker-compose/.env`
|
|
|
|
|
|
`make help` will give overview of make targets
|
|
|
|
|
|
`make provision` will pull / build the necessary images and start containers.
|
|
|
|
|
|
## Using Docker-compose
|
|
|
|
|
|
All relevant files are in folder `docker-compose`
|
|
|
|
|
|
Basic setup with NO customizations would require:
|
|
|
|
|
|
`cd docker-compose`
|
|
|
`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.
|
|
|
For more info on environment and configuration please see [[Environment and Configuration]] |
|
|
\ No newline at end of file |