This repository contains a Dockerfile to build a Docker image to run and test Cantaloupe. Cantaloupe is an open-source image server writtin in Java and complies with the IIIF Image API.
Basic authorization is handled by the iiif-auth-proxy
For more information, see:
Docker & Docker Compose
First make sure
To start Cantaloupe, run:
docker-compose up --build server
Now, Cantaloupe is running on port 8080 (http://localhost:8080/).
By default, Cantaloupe will serve the images in the example-images directory. This directory currently contains a couple images.
To view the image information of this image, go to:
To view a scaled version of the image:
And to rotate the image by 90°:
Notes:
- The Dockerfile in this repository is based on a Dockerfile from MIT Libraries;
There are many ways of viewing IIIF images. For testing purposes, you can use this Observable Notebook:
To view General view, looking southwest to Manhattan from Manhattan Bridge, Manhattan from the Cantaloupe server on localhost:8080:
Edepot links (BWT app) are structured as follows:
https://localhost:8080/iiif/2/<identifier>/full/1000,/0/default.png
Where the identifier is:
<namespace>:<stadsdeel>-<dossier_id>-<document_id>_<scan_id>.jpg
With the extra note that dossier_id and scan_id are padded with zeros to a length of 5 digits.
An example URI is as follows:
edepot:SA-00037-SA00000244_00002.jpg
Source resolution is done through the "delegate" script. Depending on the "identifier" part of the URI the filesystem or http source is used. See the config/delegates.rb script for exact resolution rules.
See:
Run
./scripts/run_test_docker.sh