Skip to content
gotenbergPublic

Repository files navigation

Gotenberg Logo

Gotenberg

A Docker-based API for PDF

Total downloads (gotenberg/gotenberg) Continuous Integration Go Reference

gotenberg%2Fgotenberg | Trendshift

Documentation · Live Demo · Community


Gotenberg is a Docker-based API for PDF. It converts web pages and office documents to PDF, then merges, stamps and signs them, makes them archival or accessible, and delivers them. Trusted in production by thousands of companies, and adopted by notable open-source projects.

Send your files via multipart/form-data, get a PDF back. No need to manage Chromium, LibreOffice, or fonts yourself.

Quick Start

docker run --rm -p 3000:3000 gotenberg/gotenberg:9

Convert a URL to PDF:

curl \
  --request POST http://localhost:3000/forms/chromium/convert/url \
  --form url=https://sparksuite.github.io/simple-html-invoice-template/ \
  -o invoice.pdf

Make it a PDF/A-2b in the same request:

curl \
  --request POST http://localhost:3000/forms/chromium/convert/url \
  --form url=https://sparksuite.github.io/simple-html-invoice-template/ \
  --form 'stages=[{"op":"remediate","profile":"PDF/A-2b"}]' \
  -o invoice.pdf

Coming from Gotenberg 8? gotenberg/gotenberg:8 stays available, and the upgrade guide maps every route, field and flag to its Gotenberg 9 counterpart.

Features

  • HTML, URL, Markdown to PDF via Headless Chromium
  • Office documents to PDF via LibreOffice (100+ formats)
  • Merge, split, select, rotate, stamp PDFs, and fill or flatten their forms
  • PDF/A and PDF/UA: validate, then remediate until the PDF conforms, Factur-X included
  • Sign, timestamp, encrypt, redact, optimize PDFs
  • Render pages as images, and screenshots of URLs and HTML
  • Read and write metadata, bookmarks and attachments

See the full documentation.

Contributing

Sponsors

If Gotenberg powers your workflow or your business, consider becoming a sponsor.

Historic & GitHub Sponsors

Powered By

Releases

Sponsor this project

Used by

Contributors

Languages