Dockerfile deployment of Loris 2.0.1 IIIF Image Server with OPENJPEG 2.1
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 42 commits ahead, 10 commits behind loris-imageserver:development.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.dockerignore
Dockerfile
LICENSE
README.md
loris2.conf
webapp.py

README.md

Docker build of Loris 2.0.1 IIIF Image Server with OPENJPEG 2.1 on Ubuntu 14.04

A Dockfile deployment of Loris image server with OPENJPEG @ https://github.com/uclouvain/openjpeg and https://github.com/loris-imageserver/loris

Docker hub respository @ https://hub.docker.com/r/bdlss/loris-openjpeg-docker/

Build successes are logged @ https://hub.docker.com/r/bdlss/loris-openjpeg-docker/builds/

Dockerfile forked from https://github.com/loris-imageserver/loris-docker/blob/development/Dockerfile and changed to use Pillow/OPENJPEG 2.0.1.

IIIF validator v 1.0.0 @ https://pypi.python.org/pypi/iiif-validator/1.0.0

Please also refer to https://github.com/loris-imageserver/loris/issues/61

Use pre-built image

Download image from docker hub. Defaults to latest tag. Docker will normally run as root unless otherwise configured.

$ sudo docker pull bdlss/loris-openjpeg-docker

To run the docker command without sudo, you need to add your user (who must have root privileges) to the docker group. To do this run following command:

$ sudo usermod -aG docker <user_name>

Build from scratch (optional)

Use local Dockerfile to build image. Defaults to latest tag.

$ sudo docker build -t bdlss/loris-openjpeg-docker .

Start the container

$ sudo docker run -d -p 5004:5004 bdlss/loris-openjpeg-docker

Images

Loris bundles with it's own test images. They are stored at /usr/local/share/images/.

Test

Point your browser to http://<Host or Container IP>:5004/01/02/0001.jp2/full/full/0/default.jpg

e.g.

http://localhost:5004/01/02/0001.jp2/full/full/0/default.jpg

After starting the container, you can IIIF validate your images from the container command line:

To get to the container command line use:

sudo docker ps
sudo docker exec -it <container ID> /bin/bash

Then for an image served at http://localhost:5004/<prefix>/<image_id> the validator can be run with:

$ python /tmp/iiif-validator-1.0.0/iiif-validate.py -s localhost:5004 -p <prefix> -i <image_id> --version=2.0 -v

e.g.

$ python /tmp/iiif-validator-1.0.0/iiif-validate.py -s localhost:5004 -p '01/02' -i 0001.jp2 --version=2.0 -v

Documentation and examples

Further documentation and examples are available here https://github.com/loris-imageserver/loris-docker