-
Notifications
You must be signed in to change notification settings - Fork 6
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.
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.
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)