Skip to content

Docker Demo

Jeremy Echols edited this page Jan 31, 2024 · 7 revisions

RAIS - Docker Demo

A demo-friendly docker-compose.yml file has been set up for convenience, and uses nginx to serve up a web page running OpenSeadragon which pulls image tiles from a proxied RAIS backend.

This docker-compose setup should serve as a decent starting point for production use.

Usage

You can run a quick demo simply by running docker-compose up from this project's root. This will download the latest RAIS from dockerhub, but once it's complete, you can visit http://localhost (or configure a custom URL via export URL=http://... [before starting up the stack] if you can't use "localhost" for some reason).

Click the IIIF link, and you'll be able to see the test JP2 in two different forms using OpenSeadragon: it will look the same, but its INFO response will be slightly different from one to the other due to one of the two images having an explicitly overridden info response.

Additionally, if you put other images into docker/images, the docker setup scripts will automatically add them to the OSD tile source list, allowing you to quickly test a variety of files.

You can also test out the experimental DeepZoom support by choosing the second link from the main page.

Configuration

If you want to set up RAIS for a more production-friendly setup, the simple demo setup is a great starting point.

The basic docker-compose.yml allows you to set up a variety of configuration options from the environment, e.g. export RAIS_TILECACHELEN=1000. You can also use docker-compose.override-example.yml as a basis for your own overrides in order to extend the available environment configuration options or even mount a custom rais.toml file into the container.

For details on all configuration options available in core RAIS, see rais-example.toml. (Some plugin configuration options are not shown there - you'll want to review Plugins for more details)