Update the Conversion Service
Learn how to update the Conversion Service to the latest version on Windows and in a Docker container.
- Windows
- Docker
The Microsoft Software installer package runs all necessary steps to update your installation, including workflows, profile configurations, and integrations.
It updates the service and the main client (GUI client and shell client).
It detects the current installation version and updates all required files as appropriate.
The name of the service installer file has the format ConversionService-<versionNumber>.msi
.
If you use additional Conversion Service clients, there is a separate installer package for the Conversion Service client.
It allows you to update any additional clients that use either the GUI client or the shell client, and the Office Add-ins.
The name of the client installer has the format ConversionService-Client-<versionNumber>.msi
.
When you update the Conversion Service installation to the latest version, the configuration is no longer compatible with previous versions.
You can use the installer to update from any version to the latest version. If the installer does not detect any existing Conversion Service configuration, it installs a new instance of the Conversion Service.
Check the version of the Conversion Service currently installed using the Conversion Service Configurator. In the About tab, you can view the version number and the installation directory.
All relevant files, such as appsettings.json
and workflows, are backed up during the update.
Restore your installation using these files in the unlikely event of an error during the update process.
Do not uninstall the Conversion Service before updating.
If you do so, any Office configuration that you have set up for the service is lost.
If this happens, you need to configure the Office setup again.
To update your Conversion Service installation:
- Download the installer MSI file from Licenses & Kits area of MyPdfTools.
Check the name carefully to identify the latest version, as you may have access to more than one version. - Double-click on the MSI installation package to run the installer.
- In the Installation wizard, click Next.
- Read the license agreement, select the I accept the Terms checkbox, and click Next.
- Click Install. The installer starts to check the existing installation and make any necessary changes.
- Once the process has completed, click Finish.
Automatic update
The automatic update is available if you use the Conversion Service with Docker Compose. For more information, see Docker Compose configuration.
All relevant files, such as appsettings.json
and workflows, are backed up during the update.
Restore your installation using these files in the unlikely event of an error during the update process.
When you update the Conversion Service installation to the latest version, the configuration is no longer compatible with previous versions.
To update the Conversion Service in Docker:
- Change the value of the
IMAGE_VERSION
variable in the.env
file to the latest version. - Run Docker Compose:
docker compose up -d
Manual update
If you are using a standalone Docker container, you can update the Conversion Service manually:
- Update the Conversion Service using the Windows approach (switch the tab on this page to Windows).
- Import updated profiles to new containers based on the new version of the
pdftoolsag/conversion-service
image.