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

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.
mkdir -p marqius-debian-demo
cd marqius-debian-demo
docker run --rm -it --mount "type=bind,source=$PWD,target=/proof" debian:trixie-slim bash2. 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.
apt-get update
. /etc/os-release
printf '%s\n' "$PRETTY_NAME"
dpkg --print-architecture
command -v wkhtmltopdf || true
apt-cache policy wkhtmltopdfCommand 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:
apt-get install -y wkhtmltopdf
wkhtmltopdf --versionDebian’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.
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" --versionThe 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.
curl -fsSLo invoice.html https://marqius.com/download/wkhtmltopdf-demo/0.12.8/invoice.html.txt"$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'
exitOpen 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.