wkhtmltopdf migration

Install wkhtmltopdf on Debian 12 or 13: Bookworm and Trixie

Bookworm still has wkhtmltopdf. Trixie removed it. Find out why your install stopped and how Marqius can keep your PDF app working.

Marqius

Two illustrated invoice proofs aligned with a brass rule on a green desk

Say your Docker build worked last week. This week, the same line, apt install wkhtmltopdf, says it can’t find the package. Check whether the new image runs Debian 12 Bookworm or Debian 13 Trixie. Bookworm still has the package. Trixie removed it. Bookworm package · Debian removal discussion

Why this helps

You can tell whether you have a missing command or a missing package before changing anything. If your app already makes invoices through a wkhtmltopdf library, Marqius gives it a new PDF program to call. You can keep the invoice code and get your new server or Docker image working.

1. Open the Debian version you want to test

With Docker running, use a fresh folder. This opens Debian 13 Trixie. To see the Bookworm behavior, use debian:bookworm-slim instead.

Terminal
mkdir -p marqius-debian-demo
cd marqius-debian-demo
docker run --rm -it --mount "type=bind,source=$PWD,target=/proof" debian:trixie-slim bash

2. Check the release and package

Run the following inside the container or the Debian server that makes the PDFs. Refresh the APT lists first in a new container.

Terminal
apt-get update
. /etc/os-release
printf '%s\n' "$PRETTY_NAME"
dpkg --print-architecture
command -v wkhtmltopdf || true
apt-cache policy wkhtmltopdf

Command not found means the program name does not resolve. Unable to locate package means your package lists have no match. Bookworm should show a package candidate. Trixie removed it, so updating the lists there will not bring it back. On Bookworm, you can install the original distro package with the following commands if you need it for a test:

Terminal
apt-get install -y wkhtmltopdf
wkhtmltopdf --version

Debian’s build lacks some features of the upstream patched-Qt build. If your app already makes good PDFs, save one from your current app before you change its server. Debian package notes

3. Install Marqius beside the old program

Use this on Bookworm or Trixie. The installer checks the download before setting up the executable. For package management instead, use the signed APT guide.

Terminal
DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends bash ca-certificates curl fonts-dejavu-core poppler-utils
cd /proof
curl -fsSLo install-marqius.sh https://marqius.com/marqius-wkhtmltopdf.sh
bash install-marqius.sh --version 0.12.8 --prefix "$HOME/.local/bin" --no-wkhtmltopdf
export WKHTMLTOPDF_BINARY="$HOME/.local/bin/marqius-wkhtmltopdf"
"$WKHTMLTOPDF_BINARY" --version

The last line should show marqius-wkhtmltopdf 0.12.8. The old command is untouched.

4. Make your first invoice PDF

The studio’s Invoice 1001 uses three Marqius products as line items so you can see how they fit together. Marqius wkhtmltopdf keeps your existing PDF call working, Studio is where you design the document, and Relay generates it from a template and data. The sample amounts add up to 120.00 EUR including VAT. Open START-HERE.html after unzipping to run the invoice and check a page break. Download the print demo (ZIP) · Open the invoice PDF

If your team also checks files before they go to press, use the sample from Marqius Engine. It has a finished A4 size, 3 mm of bleed, real CMYK colour patches and a 100 mm reference you can measure at actual size. Open the press test sheet

Unzip the demo and put invoice.html in your test folder. If you're already in the terminal, you can get the same file with one command.

Terminal
curl -fsSLo invoice.html https://marqius.com/download/wkhtmltopdf-demo/0.12.8/invoice.html.txt
Terminal
"$WKHTMLTOPDF_BINARY" --page-size A4 invoice.html invoice-marqius.pdf
pdfinfo invoice-marqius.pdf | grep '^Pages:'
pdftotext invoice-marqius.pdf - | grep -F '120.00 EUR'
exit

Open invoice-marqius.pdf on your computer and check the total. Set the absolute path where your actual PDF job runs. A program installed on your host will not appear inside your app container, so include it when you build that image. Find the setting for your library · Public comparison scoreboard

Reader questions

Can I fix Unable to locate package wkhtmltopdf on Trixie with apt update?

Refreshing package lists helps when they are stale. Trixie removed wkhtmltopdf from its archive, so updating those lists will not restore it. Choose a replacement or use a separate Bookworm environment for the migration baseline.