RUBY · RAILS · WICKED_PDF · PDFKIT

Keep wicked_pdf.
Replace wkhtmltopdf.

Keep your render pdf calls and views. Give wicked_pdf or PDFKit the new executable path, then compare a representative PDF.

curl -fsSL https://marqius.com/marqius-wkhtmltopdf.sh | bash
wkhtmltopdf (current)Marqius (drop-in)
Illustrative pair of matching sample invoices
A simple, drop-in migration Keep your Ruby & Rails workflow Install in minutes Compare your own PDFs
1

Install

Install the compatible program alongside your current wkhtmltopdf.

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

wicked_pdf

If your Gemfile includes wkhtmltopdf-binary, remove it before setting the new executable path.

WickedPdf.config = { exe_path: "/usr/local/bin/wkhtmltopdf" }

render pdf: "invoice", template: "invoices/show", layout: "pdf"
3

Compare output

Render a representative document and check the PDF before switching production.

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

What to check before you switch.

PDFKit

PDFKit.configure { |config| config.wkhtmltopdf = "/usr/local/bin/wkhtmltopdf" }

Check your pages

Exercise headers, footers, tables of contents and longer text. Compare the rendered pages before you switch a production job.

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

Ruby & Rails questions

Do wicked_pdf helpers and Rails views still work?

The helpers prepare HTML in Rails. Keep them and configure wicked_pdf to run the installed wkhtmltopdf-compatible executable, then compare the PDF.

What about the wkhtmltopdf-binary gem?

If the gem supplies the old executable, remove or stop using it and set exe_path to the Marqius-compatible program you installed.

Can I keep a table of contents?

Test a document that uses your current toc options, links and page numbers. Review the complete PDF before switching.

What if wicked_pdf reports a bad executable path?

Set exe_path to the installed program, confirm the process can execute it, and try a small Rails view.