Skip to main content

A Docker-powered stateless API
for PDF files

Getting startedGitHub Logo GitHub

Available on amd64, arm64, armhf, and i386 architectures

Gotenberg Hero Logo
60+ million pulls from Docker Hub ❤️

curl \
--request POST http://localhost:3000/forms/chromium/convert/url \
--form url=https://my.url \
--form landscape=true \
--form marginTop=1 \
--form marginBottom=1 \
-o my.pdf

Convert, merge and more!

Gotenberg provides a developer-friendly API to interact with powerful tools like Chromium and LibreOffice for converting numerous document formats (HTML, Markdown, Word, Excel, etc.) into PDF files, and more!

Thanks to Docker, you don't have to install each tool in your environments; drop the Docker image in your stack, and you're good to go!

Asynchronous workflow

The webhook feature allows you to upload the output file to the destination of your choice.

There are many options to fit your requirements, from the custom HTTP headers sent to your webhook to the HTTP method used to call it.

curl \
--request POST http://localhost:3000/forms/chromium/convert/url \
--header 'Gotenberg-Webhook-Extra-Http-Headers: {"MyHeader": "MyValue"}' \
--header 'Gotenberg-Webhook-Url: https://my.webhook.url' \
--header 'Gotenberg-Webhook-Method: PUT' \
--header 'Gotenberg-Webhook-Error-Url: https://my.webhook.error.url' \
--header 'Gotenberg-Webhook-Error-Method: POST' \
--form url=https://my.url

A modular platform

Gotenberg is a platform composed of modules; each module has properties you may customize to your flavor.

docker run --rm -p 80:80 gotenberg/gotenberg:8 gotenberg --api-port=80 --api-timeout=10s --libreoffice-disable-routes --log-level=debug

🚀 More customizations? Build your own Docker image by adding new tools and create modules that provide new routes to the API.

Go Reference

They sponsor Gotenberg

TheCodingMachine LogoZolsec Logo

Sponsorships help maintaining and improving Gotenberg - become a sponsor ❤️