Mounting a docker data volume

Warning

Please be aware that the performance of this volume is critical to the performance of the server in general, and that the server operates under the assumption that the files will not be modified or locked by another process. A latency gain will be incurred if using a shared volume for storing cached data.

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:

Shell

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

or through docker run

Shell

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 is not actively supported and prone to issues.

Common Issues

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.