pdfToolbox CLI Docker Image from Docker Hub

callas pdfToolbox CLI is now available as a pre-built Docker image on Docker Hub, simplifying deployment and ensuring consistency across environments. This guide explains how to use the image and configure licensing.

Prerequisites

  • Docker installed on your system (Installation Guide)
  • A valid callas license (via a License Server or an OEM agreement)

Quick Start

Pull the callas pdfToolbox CLI Docker image ...

docker pull callassoftware/pdftoolbox-cli
Click to copy

Run a basic command ...

docker run --rm callassoftware/pdftoolbox-cli ./pdfToolbox --version
Click to copy

Licensing Setup

pdfToolbox-cli requires a License Server to manage activations. Docker containers are ephemeral, so license activation data cannot persist in the image itself.

Option 1: 

pdfToolbox --licenseserver=licenseserver.callassoftware.com --lsmessage=6d203314-e87e-11ef-9b89-db96358f5fef sample.kfpx sample.pdf -o=o.pdf
Click to copy

Option 2:

  • Self-Hosted License Server
    • specify the --licenseserver=<your licenseserver IP> option, e.g. ...
pdfToolbox --licenseserver=192.168.188.42 sample.kfpx sample.pdf -o=o.pdf
Click to copy

Option 3:

  • For embedded or high-volume use cases, contact callas for OEM agreements: [email protected]

Best Practices

Avoid the latest tag in production. Instead use versioned tags like callassoftware/pdfToolbox-cli:v16-1-661 for stability.

Troubleshooting

"License not found" errors: Verify the License Server is reachable and the specified license server is set correctly. Also verify that you have a valid cartridge installed

Docker-snippets repository

The docker-snippets repository on GitHub provides examples and instructions for creating custom Docker images. Find more information here.