DOWNLOAD AND INSTALL

Install Marqius.
Check your PDFs.

Keep your existing tools. Verify the result on your own documents before switching production.

1 Install

curl -fsSL https://marqius.com/marqius-wkhtmltopdf.sh | bash

2 Check your PDF

marqius wkhtmltopdf invoice.html new.pdf
marqius compare old.pdf new.pdf
Terminal
Platform: macOS arm64
Downloaded: Marqius 0.11.0
SHA-256 verified: OK
Installed: Marqius beside wkhtmltopdf

Next: check a document you already use.

SHA-256 verified Existing wkhtmltopdf stays until you choose to take over Undo when ready

Install, then check your PDF.

1

Install beside your current program

The installer detects your platform, verifies the checksum and preserves an existing wkhtmltopdf.

curl -fsSL https://marqius.com/marqius-wkhtmltopdf.sh | bash
2

Compare a real document

Generate a PDF from your HTML, then compare it with a known-good copy before switching production.

marqius wkhtmltopdf invoice.html new.pdf
marqius compare old.pdf new.pdf
PRACTICAL DETAILS

What to check before you switch.

Choose when to take over

An existing wkhtmltopdf remains untouched by default. Use --take-over only after testing. --rollback restores a prior Marqius version; --uninstall restores a program the installer replaced.

curl -fsSL https://marqius.com/marqius-wkhtmltopdf.sh | bash -s -- --take-over

Install on Debian with APT

Use the signed Marqius APT repository on Debian 12 or 13 for amd64 and arm64. The package installs its own executable so you can check it beside your current converter.

Signed APT installation

Optional Python and PHP helpers

These MIT-licensed helpers configure an already installed executable. Use the Python wheel URL with pip install, or add https://marqius.com/download/helpers as a Composer repository and require marqius/marqius-snappy:0.1.1.

Python helper wheelComposer helper source ZIP
Marqius is proprietary software from Simple AI LLC. It is independent of the wkhtmltopdf project. Other product names identify the tools discussed in these guides.
QUESTIONS & ANSWERS

Download questions

Will the installer replace my existing wkhtmltopdf without asking?

No. It installs Marqius and leaves an existing wkhtmltopdf alone. Use --take-over only after you have checked your PDFs.

How is the program download verified?

The installer checks the SHA-256 digest of the downloaded executable against the checksum published beside that release before installing it.

Does Marqius need Qt, X11 or a browser?

Basic rendering does not require Qt or X11. Pages that depend on browser JavaScript may need Chrome or Chromium; test the pages your application actually uses.

Which fonts will my PDFs use?

The converter uses fonts available to its environment. Add the fonts your documents expect, especially in minimal Docker images, and compare text wrapping before switching.

Can I install it beside the original and undo an update?

Yes. Keep the original in place while testing. The installer supports --rollback for the prior Marqius version and --uninstall to restore a wkhtmltopdf it replaced.

Can I download it for Windows?

The current release has Linux x86-64, Linux ARM64 and Apple silicon macOS builds. A Windows build is still in testing.