Setting up Cantaloupe IIIF Image Server

Make sure you have installed the prerequisites.

Download Cantaloupe

For more information, checkout the Cantaloupe getting started guide.

Download Cantaloupe v3.4.2

Open and extract the zip file to your directory of choosing. We suggest ~/Desktop.

Now change directory to that extracted directory

$ cd ~/Desktop/Cantaloupe-3.4.2

Configure Cantaloupe

Now lets create a copy of the configuration file:

$ cp cantaloupe.properties.sample cantaloupe.properties

Now lets enable the admin panel where we will modify the rest of the settings.

Scroll to line 104, and change false to true. Also add a password.

# Enables the Control Panel, at /admin.
- admin.enabled = false
+ admin.enabled = true
- admin.secret =
+ admin.secret = yolo

Save the file.

Now lets try and start the server. Run this command from your Cantaloupe directory

$ java -Dcantaloupe.config=./cantaloupe.properties -Xmx2g -jar Cantaloupe-3.4.2.war

Now navigate to http://127.0.0.1:8182/iiif/2 in your browser.

You should see this:

server image

Congrats you successfully installed Cantaloupe!

Also make sure you can get into the admin panel by navigating to http://127.0.0.1:8182/admin.

Use the username admin and the password you set previously.

admin panel

Last modified by Glen Robson 2020-11-26 11:36:05
Created by Glen Robson 2020-11-26 11:36:05

results matching ""

    No results matching ""