Quick Start

Requirements

Galia is a Java application that requires a minimum Java Runtime Environment (JRE) version of 22. (Newer versions are also likely to work.) Linux, macOS, and Windows are supported.

The core application has no external dependencies, but some plugins do—see the relevant plugin page for more information.

Configure

The distribution archive bundles a configuration file named config/config.yml. Open it in a text editor and set source.FilesystemSource.BasicLookupStrategy.path_prefix to a folder path containing some images. For now, all other settings can be left as-is.

Run

From a command prompt, invoke the bin/start.sh script (or bin/start.cmd in Windows).

Now, assuming that there is an image named image.tif residing in the location you set source.FilesystemSource.BasicLookupStrategy.path_prefix to, try accessing these URLs:

• http://localhost:8182/iiif/3/image.tif/info.json
• http://localhost:8182/iiif/3/image.tif/full/600,/0/default.jpg

See the IIIF Image API 3.0 documentation for more information about this URL syntax.

Next steps

At this point, you have a basic working image server that serves images from the local filesystem and supports all bundled image sources, and all formats supported by the bundled decoders and encoders.

• If you'd like to host images elsewhere than on an attached filesystem, look into alternative source plugins.
• If you'd like to read and deliver images in formats other than the ones supported by the core application, look into alternative codec plugins.
• If you need to customize the server's behavior, such as to perform a service lookup to locate source images, you'll need to implement a delegate.
• Consider employing caching to lighten server load and boost performance.

To get an idea of everything Galia can do, explore the rest of this guide.