Image Servers

These servers support the IIIF Image API. Some may also have support for the Presentation API.

• Loris written in Python.
• IIPImage Server high performance image server.
• riiif written in Ruby as a Rails engine.
• SIPI IIIFv2 image server written in C++.
• RAIS 100% open source tile server for JP2 images written in Go.
• digilib image server written in Java.
• Cantaloupe - image server written in Java.
• iiif_s3 Ruby library for generating a static IIIF level 0 Image and Presentation API server on Amazon S3.
• Hymir IIIF Server IIIF server written in Java supporting IIIF Image and Presentation API.
• go-iiif IIIF server written in go (fork of greut/iiif).

Getting started with Loris

In the repository of simple scripts created to go along with this workshop:

https://github.com/mattmcgrattan/oslo_demos

I provide a very simple shell script that wll use Docker to run Loris.

Deploying Loris using Docker

Loris provides a Docker version of the image server.

https://github.com/loris-imageserver/loris-docker

Installing Docker

Mac:

https://docs.docker.com/docker-for-mac/install/

Windows:

https://docs.docker.com/docker-for-windows/install/

Linux:

• Centos: https://docs.docker.com/install/linux/docker-ce/centos/
• Ubuntu: https://docs.docker.com/install/linux/docker-ce/centos/

Running Loris

There is a shell script provided in this repository, if you run:

./loris_docker.sh

This script will download the correct Docker image and spin up a Loris image server, and serve images from the ./images folder.

You can test if this is working by loading:

http://localhost:8000/test.jp2/info.json

in your browser to check an info.json file is being returned.

Then try:

http://localhost:8000/test.jp2/full/250,/90/default.jpg

The documentation at:

https://github.com/loris-imageserver/loris-docker
provides more general information on spinning up the Dockerised version, although with one caveat, it may be necessary to change the volume mapping from:

docker run -d -v <your-img-folder>:/usr/local/share/images -p 5004:5004 <docker-image>

to

docker run -d -v <your-img-folder>:/opt/loris/tests/img -p 5004:5004 <docker-image>

if you are following that documentation.