Sample Rails app for creating PDFs on Heroku
Latest commit 1abf9a8 Oct 30, 2010 Jordan Brough update to wkhtmltopdf-0.10.0_beta5
also fix passing of "quiet" param for newer wkhtmltopdf


Heroku PDF Generation

Working Sample:

Based on


A rails sample app that generates PDFs from html, works on and is so painless it hurts.

Install steps:

  • sudo gem install heroku (if not already installed)
  • git clone git://
  • cd heroku-pdf
  • heroku create your-great-app-name --stack bamboo-ree-1.8.7
  • git push heroku master
  • visit

Presto pdf.

Running locally

The app is setup to use rails-root/bin/wkhtmltopdf-amd64 in production via this initializer code. This setting is overridden in development to look for /usr/local/bin/wkhtmltopdf in development mode (via this after_initialize block). If you want to run in development mode and are on an amd64 architecture you can just delete the after_initialize block. Otherwise, you'll probably want to grab wkhtmltopdf and update the after_initialize path as appropriate.

Asset Paths

Due to how wicked_pdf invokes wkhtmltopdf (the html file is supplied via stdin rather than as a url) all asset urls need to be absolute file paths rather than relative urls. For Rails usage, we can use ActionController::Base.asset_host to switch the path when the request format is pdf. (see here). We also need to extract any urls out of static stylesheets and put them into Rails templates instead so that the path can be swapped out to a file path when necessary. Example:

<style type="text/css" media="screen">
  #menu a {
    background: url(<%= image_path('menu.gif')%>) no-repeat;

wkhtmltopdf version

Currently includes wkhtmltopdf version 0.9.9 static amd64 (works on heroku).