PhotomatixCL Installation Guide

Installation process

Installing PhotomatixCL involves downloading the program and installing it. If you purchased a subscription, it also involves loading the license key you received.

You will find instructions for downloading and installing on the PhotomatixCL product page.

The information further down this page provides additional information for:

installing on Linux (choosing a Linux build and troubleshooting installation issues)
loading your license key

Choosing a Linux build

There are three builds of PhotomatixCL:

Ubuntu build: Ubuntu 23.04 & 24.04 / Linux Mint 22 (X64_86 architecture)
Universal build: Statically linked (X64_86 architecture)
ARM build: Debian (ARM architecture)

The Ubuntu and ARM builds are dynamically linked, the Universal build is statically linked. The pros and cons of both is detailed below.

Build type	Pros	Cons
Dynamically linked (Ubuntu & ARM builds)	Build for a specific distro means less incompatibility issues Enables lens correction for supported cameras and lenses Automatic updates to third-party libraries used by PhotomatixCL	Doesn't run on distros other than the one it is built for May require additional packages to be installed to resolve all library dependencies
Statically linked (Universal build)	Works on a wide range of distributions Avoids issues of missing libraries	Doesn't include lens correction

Build type

Pros

Cons

Dynamically linked

(Ubuntu & ARM builds)

Build for a specific distro means less incompatibility issues
Enables lens correction for supported cameras and lenses
Automatic updates to third-party libraries used by PhotomatixCL

Doesn't run on distros other than the one it is built for
May require additional packages to be installed to resolve all library dependencies

Statically linked

(Universal build)

Works on a wide range of distributions
Avoids issues of missing libraries

Doesn't include lens correction

Conclusion: The statically linked build is a better choice unless your workflow relies on PhotomatixCL to perform lens correction of RAW files.

Troubleshooting installation issues

Ubuntu build

If you installed the Ubuntu build and are getting errors about missing libraries, install the Universal build (statically linked version) instead.

Universal build

If you run the statically linked version build and get an error about missing library libgomp.so.1 or something similar, install your distro's libgomp package, which PhotomatixCL uses to provide multi-threaded performance.

You can install it with commands such as these, depending on your distro:

Debian / Ubuntu	sudo apt install libgomp1
RHEL / CentOS / Rocky / Alma	sudo dnf install libgomp
Fedora	sudo dnf install libgomp
openSUSE	sudo zypper install libgomp1
Arch Linux	sudo pacman -S libgomp

Loading your license key

When you purchase a subscription, you will receive a license key that you load using the -ll command:

<PathToPhotomatixCL> -ll <LicenseKey>

Before loading your license key, you will need to ensure that your server has Internet access:

Lite subscription

For a Lite subscription, your server needs Internet access when you load the license key.

It will also need Internet access when PhotomatixCL checks the license the first time it runs and then once a month. (Specifically, it will need to connect to port 80 of hdrsoft.com.)

Growth subscription

For a Growth subscription, your server needs to have Internet access at all times, though it will still work accross limited temporary outages.

It will need to connect to port 443 of tracking.hdrsoft.com.

Previous: Introduction

Next: Examples