How does the docker image work?
The FormVu Docker image provides an easy way to run FormVu as a web service. The image extends the official Tomcat OpenJDK21 image and includes LibreOffice and Google Noto fonts which allows FormVu to handle office documents in addition to the PDF file support provided as standard.
The docker image is designed to run formvu-microservice-example which is an open source wrapper for running FormVu 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 FormVu 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 formvu-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 FormVu is used simply switch off the container, change the mounted file, and restart the container.
The source code for the FormVu docker image is available on GitHub, and for more information follow our How to run the FormVu Docker Image tutorial.