About

This repository contains the docker container of our IIIF server user by the Early Chinese Periodicals Online ECPO.

iipsrv was developed by ruven/iipsrv, the BASE image for our implementation is by dfukagaw28/iipsrv.

Usage

Pull the image to start the container.

docker pull hra1/iipsrv:latest
docker run  -p 8000:80 hra1/iipsrv:latest

Alternatively, build the image from source:

cd hcts-hra/iipsrv
docker build .
docker run  -p 8000:80 <ID-REPORTED-BY-BUILD>

You should be able to visit the working IIIF server at localhost:8000

Test

a simple php test files and accompanying test image are part of these docker images, you can visit: localhost:8000/ to see the working server and this page for a sample image.

to execute the test suite (written in bats) simple call:

bats test/*.bats

Gotcha: To run the tests the default.jpg test images retrieved as part of a normal test run must not be present on the filesystem, e.g. from a previous manual run of the test. Some IDEs hide ignored files by default.

Using a Persistent Volume

We recommend separating the data and server application by mapping a docker volume.

1. Create a data directory on your disk, e.g. ~/data/ecpo/

2. Copy images into this folder.

    docker run -d -p 8000:80 -v ~/data/ecpo/ hra1/iipsrv

Build Arguments and Configuration Option

We are currently using the default iipsrv configuration setting, the matching configuration file is located in src/lighttpd/lighttpd.conf.