Mounting a docker data volume

As of version WebViewer Server 1.5.0 mounting of the cache directory /usr/local/apache-tomcat/static_data with Docker to a local directory or another volume on your system is supported.

1. Mount your volume to /usr/local/apache-tomcat/static_data

This can be done in docker-compose through the volumes specifier in docker-compose.yml:

volume:
  /usr/local/apache-tomcat/static_data:/my_static_data_folder

or through docker run

docker run -v /usr/local/apache-tomcat/apache-tomcat:/my_static_data_folder

At this point all data created by the container will be copied to the mounted volume. WebViewer Server will continue to manage the cache within this volume.

It is possible to share a mounted volume with multiple WebViewer Servers, this will cause them to have a shared cache. This can be done by simply mounting the volume on both containers.

There can sometimes be permissions issues when mounting data volumes. In order to avoid these, it is necessary for users to ensure the directory on the host server exists, and needs to be owned by the docker group with permissions set to g+rxw.