Host your own PDF Blocks server in Heroku

Heroku is the easiest way to host your own PDF Blocks server.

It takes less than 5 minutes to have your PDF server running and ready to use in platforms (like Power Automate and Zapier) or in your own applications using the API.

Create the app

Sign up for a free Heroku account if you don’t have one.

Then deploy PDF Blocks to Heroku.

Give your app an App name and choose to host your application either on US or European servers.

Your PDF server will be available in https://{app-name}.herokuapp.com

Choose an app name

Set an API key

Create an API key (or password) to protect access to your PDF Blocks server. You can choose any string. In this example, we use pa55w0rd as the API key.

Get the SHA-256 hash of the API key. For example, the hash of pa55w0rd is:

56965e2a1a995c74da500088947af11dfa27951cc350d0b97d0633075969c31b

In the form in Heroku, set the API_KEY_HASH environment variable to the hash:

Paste the API key

Leave the LICENSE_KEY set to evaluation, and click Deploy app.

Deploy

After your PDF Blocks server is ready, you can use it in your integration platform or application with the hostname {app-name}.herokuapp.com and the API key you chose — pa55w0rd in our example.

License Key

You can use the evaluation version of PDF Blocks server for as long as you want.

When you are ready, buy a license. You will get a license key like this:

acme-inc[eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJeyJzdWIoiOiJhY21lLWluYyIsIm5hbWUiOiJBQ01FLCBJbmMiLCJhY2MiOiIxNTAwIiianRpIjoiMzk5MTk0MTgxIiwiZXhwIjoxNjI0MzEyMDYwLCJpc3MiOiJwZGZibG9ja3MiLCJhdWQiOiJwZGZibG9ja3Mvc2VydmVyIn054oW5HEa 5wOui9NQcARLyD75Yah6kqkPMrp9EiOF0eeLuutj8Kc12cDLiXU00BuKg4EkNHHm9TVFtdvv6Md7IA]

(We added line breaks for clarity, but don’t split your license key in multiple lines)

To configure your new license key in your Heroku app, go to your Heroku Dashboard and click on your app name, then click on Settings.

Under Config Vars click Reveal Config Vars. Click the pencil icon next to the LICENSE_KEY variable name, replace evaluation with your full license key, and click Save changes.