Get Started

This is a short guide to help you get going quickly with a typical standalone configuration. The user manual contains a more in-depth version of this guide that covers some additional features, like running in a web container, and using the web-based "control panel."

Requirements

The baseline 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.


Download


Configure

The distribution archive bundles a sample configuration file, named cantaloupe.properties.sample. Do not edit this file—instead, create a copy and edit that.

To get started quickly, just set FilesystemResolver.BasicLookupStrategy.path_prefix to a folder path containing some images, and leave all the other options alone.


Run

From the command prompt (OS X/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

Cantaloupe is now running. Assuming you have an image named image.tif, try accessing:


Upgrading

For step-by-step upgrade instructions, see the "Upgrading" section of the user manual.


Next Steps

The user manual is the central source of documentation, organized by feature. Also, the configuration file contains a lot of inline documentation. If you have questions, don't be afraid to ask for help.