How does the docker image work?
The BuildVu Docker image provides an easy way to run BuildVu as a web service. The image extends the official Tomcat OpenJDK21 image and includes LibreOffice and Google Noto fonts which allows BuildVu to handle office documents in addition to the PDF file support provided as standard.
The docker image is designed to run buildvu-microservice-example which is an open source wrapper for running BuildVu as a web service with a REST API. This provides a simple way to set up a server locally or deploy to a cloud platform.
Before running the docker image you will need to obtain a copy of the BuildVu Microservice WAR file. You can build this yourself or download a copy.
The WAR file must be mounted when the container is started. When launching the container, the entrypoint.py script runs which ensures the buildvu-microservice WAR file is mounted and starts the Tomcat process.
The mounted war file should not be modified or deleted whilst the image is running. To change which version of BuildVu is used simply switch off the container, change the mounted file, and restart the container.
The source code for the BuildVu docker image is available on GitHub, and for more information follow our How to run the BuildVu Docker Image tutorial.