Deployment

This guide walks you through deploying bkhtmltopdf Enterprise Edition (EE) using Docker. The Enterprise Edition supports headless mode, making it suitable for production environments.

After a successful purchase, you will receive an activation email containing your activation code (LICENSE).

warning

bkhtmltopdf Enterprise Edition supports Docker deployment only, compatible with Docker CE and Docker EE (version 20.10+).

Prerequisites

Install Docker

Refer to the official documentation for detailed installation instructions: https://docs.docker.com/engine/install/

Verify installation:

docker --version

Output should resemble: Docker version 27.0.3, build 7d4bcd8.

tip

Ensure Docker service is running and sufficient disk space is available (minimum 10GB for images and data).

Deployment Steps

Start Container

Launch the container using the activation code. Recommended configuration:

• --shm-size=256mb: Allocate shared memory to enhance Chromium rendering performance.
• -e BKHTMLTOPDF_LICENSE="YOUR_LICENSE": Replace with the activation code from your email.
• -p 8080:8080: Map ports to host 8080.
• --restart always: Enable automatic restart.

docker run --shm-size=256mb --name bkhtmltopdf-ee \
  -e BKHTMLTOPDF_LICENSE="YOUR_LICENSE" \
  -itd --restart always -p 8080:8080 bkhtmltopdf/bkhtmltopdf-ee:latest

• Replace YOUR_LICENSE with your actual activation code.

View logs:

docker logs bkhtmltopdf-ee

Successful startup logs resemble:

Tomcat started on port 8080 (http) with context path ‘/’
Started Application in 1.792 seconds

Verify Deployment

• Visit http://127.0.0.1:8080/ui/index.html
• If you see the Enterprise Edition UI interface, the deployment is successful.

Translated with DeepL.com (free version)