🍈 Cantaloupe
High-performance dynamic image server in Java
https://medusa-project.github.io/cantaloupe/
This is a very-quick-start guide. The user manual at the website above is the primary source of documentation, containing additional information about Servlet container and Docker setup, and also upgrade instructions.
Requirements
The only requirement is Java 8; either the Oracle JRE or OpenJDK will work. Optional components, such as particular processors, may have additional requirements; see the user manual.
Configure
The distribution archive bundles a sample configuration file, named
cantaloupe.properties.sample
. Make a copy and open it in an editor. Set
FilesystemResolver.BasicLookupStrategy.path_prefix
to a folder path
containing some images.
Run
From the command prompt (macOS/Linux):
java -Dcantaloupe.config=/path/to/cantaloupe.properties -Xmx2g -jar Cantaloupe-x.x.x.war
From the command prompt (Windows):
java -Dcantaloupe.config=C:\path\to\cantaloupe.properties -Xmx2g -jar Cantaloupe-x.x.x.war
Then, assuming you have an image named image.tif
, try accessing:
- http://localhost:8182/iiif/2/image.tif/info.json
- http://localhost:8182/iiif/2/image.tif/0,0,200,200/full/0/default.jpg
License
Cantaloupe is open-source software distributed under the University of Illinois/NCSA Open Source License; see the file LICENSE for terms.