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."
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.
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:
For step-by-step upgrade instructions, see the "Upgrading" section of the user manual.
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.