Install Marqius wkhtmltopdf with APT on Debian
Install Marqius with APT on Debian 12 or 13. Keep your old wkhtmltopdf command while you check a PDF with Marqius.
Marqius

Say your invoice app is moving to a new Debian server. You want it to keep making the same PDFs, and you want APT to manage the new PDF program the way it manages your other packages. You can install Marqius through its signed APT source on Debian 12 or 13, on amd64 or arm64.
Why this helps
The package gives your app a clear path to the new program, /usr/bin/marqius-wkhtmltopdf. The old wkhtmltopdf command stays available. You can have one app try Marqius while other jobs keep using the old tool, and use APT to manage future updates or remove the package.
1. Open a disposable Debian shell
You need Docker running. This example tests Trixie. Use debian:bookworm-slim in the same command if you want to try Debian 12.
mkdir -p marqius-apt-demo
cd marqius-apt-demo
docker run --rm -it --mount "type=bind,source=$PWD,target=/proof" debian:trixie-slim bashRun the remaining blocks inside that shell. You're already root in this container. To apply the package setup on a real Debian host, run the system changes as a user with sudo.
2. Download and check the signing key
apt-get update
DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends ca-certificates curl gpg poppler-utils
curl -fsSLo marqius-archive-keyring.gpg https://marqius.com/download/apt/marqius-archive-keyring.gpg
gpg --show-keys --with-fingerprint marqius-archive-keyring.gpgCheck for BFF2 545B B544 3FDB 31CE 801B 421B 8E68 D7C2 2538 before continuing. APT uses this key to check the Marqius package list.
3. Add the source and install the package
install -d -m 0755 /etc/apt/keyrings
install -m 0644 marqius-archive-keyring.gpg /etc/apt/keyrings/marqius-archive-keyring.gpg
cat > /etc/apt/sources.list.d/marqius.sources <<'SOURCES'
Types: deb
URIs: https://marqius.com/download/apt/
Suites: stable
Components: main
Architectures: amd64 arm64
Signed-By: /etc/apt/keyrings/marqius-archive-keyring.gpg
SOURCES
apt-get update
apt-cache policy marqius-wkhtmltopdf
apt-get install -y marqius-wkhtmltopdf
marqius-wkhtmltopdf --versionYou should see an available version and then the installed version. The package also installs DejaVu fonts. Your production PDFs may need the same fonts you used on the old server.
4. Make and check a PDF
cd /proofThe 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.txtmarqius-wkhtmltopdf --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 from the demo folder. If it has one page and reads Total due: 120.00 EUR, the converter made the file. In a test copy of your app, set your library's path to /usr/bin/marqius-wkhtmltopdf and repeat the test with an invoice your app actually sends. Exact setting for each library · Public comparison scoreboard
The disposable container goes away when you exit. If you installed on a test host and want to undo it, run sudo apt-get remove marqius-wkhtmltopdf. The old wkhtmltopdf command stays in place. Trial and licensing
Reader questions
Does apt install marqius-wkhtmltopdf replace the existing wkhtmltopdf command?
The package installs /usr/bin/marqius-wkhtmltopdf. It leaves the wkhtmltopdf command and the Debian package that owns it in place.