Public | Automated Build

Last pushed: 3 years ago
Short Description
Short description is empty for this repo.
Full Description


wkhtmltopdf in a docker container as a web service.

This image is based on the
wkhtmltopdf container.

Running the service

Run the container with docker run and binding the ports to the host.
The web service is exposed on port 80 in the container.

docker run -d -P openlabs/docker-wkhtmltopdf-aas

The container now runs as a daemon.

Find the port that the container is bound to:

docker port 071599a1373e 80

where 071599a1373e is the container SHA that docker assigned when
docker run was executed in the previous command.

Take a note of the public port number where docker binds to.

Using the webservice

There are multiple ways to generate a PDF of HTML using the

Uploading a HTML file

This is a convenient way to use the service from command line
utilities like curl.

curl -X POST -vv -F 'file=@path/to/local/file.html' http://<docker-host>:<port>/ -o path/to/output/file.pdf


  • docker-host is the hostname or address of the docker host running the container
  • port is the public port to which the container is bound to.


If you are planning on using this service in your application,
it might be more convenient to use the JSON API that the service

Here is an example using python requests:

import json
import requests

url = 'http://<docker_host>:<port>/'
data = {
    'contents': open('/file/to/convert.html').read().encode('base64'),
headers = {
    'Content-Type': 'application/json',    # This is important
response =, data=json.dumps(data), headers=headers)

# Save the response contents to a file
with open('/path/to/local/file.pdf', 'wb') as f:


  • Implement conversion of URLs to PDF
  • Add documentation on passing options to the service
  • Add curl example for JSON api
  • Explain more gunicorn options

Bugs and questions

The development of the container takes place on
Github. If you
have a question or a bug report to file, you can report as a github issue.

Authors and Contributors

This image was built at Openlabs.

Professional Support

This image is professionally supported by Openlabs.
If you are looking for on-site teaching or consulting support, contact our
sales and support teams.

Docker Pull Command
Source Repository