/cantaloupe-docker

Containerizing https://cantaloupe-project.github.io/

Primary LanguageDockerfile

README

This repo shows how build and run a Cantaloupe (v5+) container image as there is no official Docker image yet. It was based off of MITLibraries/docker-cantaloupe and modified to accommodate for the changes in v5.x

Building

docker build -t cantaloupe:5.0.3 .

GrokProcessor

At the time of writing, the libgrokj2k deb package package is still does not have a stable version and hence it is not currently being installed

TurboJpegProcessor

If you don't need the TurboJpeg proccessor, you can delete that RUN step and change the default-jdk package to default-jre-headless and this should reduce your image size by ~250MB

How to Run

docker run --env-file env_list.sample -p 8182:8182 cantaloupe:5.0.3

They have some decent Getting Started documentation as well as Intro to IIIF so be sure to check those out.

Gotchas!

When I started working on this, I didn't have much experience with Cantaloupe nor did I have a very complex setup, so I was looking at the Admin Control Panel/UI to validate that settings/values were correct. What I didn't know was that the UI is not very source of truth for settings and spent more time than I would have like to admit trying to troubleshoot this before I made a GitHub Issue. So, don't expect to see the your settings passed via environment variables to show up in the Admin Control Panel/UI.