Setting LibreOffice path

Table of contents

1. What is its function
2. How to set this value
3. Default Value
4. How to use with Docker

---

What is its function

This option allows you to specify the full path to execute LibreOffice when handling non-PDF files.
When provided the microservice will use this value to call LibreOffice and convert office documents to PDF which will then be converted.
This function requires LibreOffice to be installed, otherwise non-PDF files will not be converted. This function is controlled by 1 config property.

1. libreOfficePath - The path to LibreOffice including the executable or the executable name if LibreOffice is on the path

How to set this value

Create the following Java properties file on the server running your app server (if you don’t already have one) {user.home}/.idr/buildvu-microservice/buildvu-microservice.properties

In this file add (or update if the key already exists) the following key and value pair.

1. libreOfficePath - This must be a string representing a path for LibreOffice.
   e.g libreOfficePath=soffice

Default Value

When no values are provided or invalid values are provided the following default values are used.

1. libreOfficePath=soffice

Note - If libreoffice isn’t installed or the path does not point towards the libreoffice executable then non-PDF files will not be converted.

How to use with Docker

In order to provide your own properties file to the Docker image you need to mount the properties file to the image. This is done by adding the following to your docker run command.

--mount "source=/path/to/properties/directory/buildvu-microservice.properties,target=/root/.idr/buildvu-microservice/buildvu-microservice.properties,type=bind"

---