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