How to run the FormVu Docker Image

Table of contents

  1. Launching FormVu
  2. Download or Build the WAR file
    1. Download the WAR file
    2. Build the WAR file
  3. Install Docker
  4. Run Docker
  5. [Recommended] Enabling HTTPS
  6. [Optional] Define auth credentials
    1. [Advanced] Adding multiple users
  7. [Optional] Mount volume
  8. Running FormVu from different language clients

Launching FormVu

FormVu has a Docker image available, called idrsolutions/formvu, to make it easier to get started. Using this Docker image you can start a container that can use FormVu to perform conversions using a simple REST API.

You can use this image from a cloud platform or server that has Docker installed. See below for instructions for using the Docker image on your own server/infrastructure.

Download or Build the WAR file

Before getting started you need the WAR file which you can either download or build yourself.
This WAR file is required for the FormVu service to work.

Download the WAR file

For trial users:

  1. If you haven’t already, sign up for FormVu trial.
  2. Open the email you receive when you signed up.
  3. Follow the download link found in the Docker section.

For customers:

  1. Visit the Customer download page.
  2. Click on ‘Download Latest Customer WAR’.
  3. Submit your username and password.

Build the WAR file

Build a copy of our FormVu Microservice Example project.
Instructions can be found on the GitHub page.

Install Docker

There are many tutorials detailing how to install docker ready for use. This tutorial to Install Docker will cover everything you need.

Run Docker

 docker run -p 80:80 --mount "source=/path/to/war/formvu-microservice.war,target=/usr/local/tomcat/webapps/ROOT.war,type=bind" idrsolutions/formvu

For production use, we strongly recommend enabling HTTPS encryption. The container is pre-configured to switch to HTTPS if it finds an SSL certificate, private key and certificate chain in the /opt/ssl/ directory. All you need to do is mount a directory containing files called certificate.crt, private.key and ca_bundle.crt. by adding the following to the above commands:

 -p 443:443 --mount "source=/local/path/to/ssl/directory,target=/opt/ssl,type=bind,readonly"

[Optional] Define auth credentials

If you wish to set a username and password for the service, you can do so by providing the following additional environment variables:

 --env ACCESS_USERNAME=<username> --env ACCESS_PASSWORD=<password>

[Advanced] Adding multiple users

If you need more than one user, you can provide your own tomcat-users.xml file and mount it at /usr/local/tomcat/conf/tomcat-users.xml

[Optional] Mount volume

If you need to access the converted files from the host machine without using the API you need to mount a drive at the output location.

This is done by adding the following to the run docker command.

 --mount "source=/path/to/documents,target=/root/.idr,type=bind"

Running FormVu from different language clients

Now that you have the docker server running you can follow the tutorials for using the API to begin your conversions.

Just click a button below if you have more questions or need any help