gotenberg/gotenberg repository overview

⁠Quick Reference

• Source code:
  https://github.com/gotenberg/gotenberg⁠
• Releases notes:
  https://github.com/gotenberg/gotenberg/releases⁠
• Supported architectures: (more info⁠)
  amd64, arm64v8, arm32v7, i386, ppc64le
• Where to get help:
  the Gotenberg Community Forums⁠⁠
• Where to file issues:
  https://github.com/gotenberg/gotenberg/issues⁠

⁠Tags

• Standard:latest, 8
  We adhere to Semantic Versioning (SemVer), using the format MAJOR.MINOR.PATCH. See the tags list⁠ if you're looking for a specific version.
• Chromium-Only: latest-chromium, 8-chromium
  Drops LibreOffice, python3, and hyphenation packages. ~30% smaller than the full image. See the tags list⁠ if you're looking for a specific version.
• LibreOffice-Only: latest-libreoffice, 8-libreoffice
  Drops Chromium and its dependencies. ~38% smaller than the full image. See the tags list⁠ if you're looking for a specific version.
• Cloud Run Optimized:latest-cloudrun, 8-cloudrun, latest-chromium-cloudrun, 8-chromium-cloudrun, latest-libreoffice-cloudrun, 8-libreoffice-cloudrun
  We adhere to Semantic Versioning (SemVer), using the format MAJOR.MINOR.PATCH. See the tags list⁠ if you're looking for a specific version.
• AWS Lambda Optimized:latest-aws-lambda, 8-aws-lambda, latest-chromium-aws-lambda, 8-chromium-aws-lambda, latest-libreoffice-aws-lambda, 8-libreoffice-aws-lambda
  We adhere to Semantic Versioning (SemVer), using the format MAJOR.MINOR.PATCH. See the tags list⁠ if you're looking for a specific version.
• Development:edge, edge-chromium, edge-libreoffice edge-cloudrun, edge-chromium-cloudrun, edge-libreoffice-cloudrun, edge-aws-lambda, edge-chromium-aws-lambda, edge-libreoffice-aws-lambda
  The latest development build from the main branch.
• Snapshots:
  https://hub.docker.com/r/gotenberg/snapshot⁠

⁠What is Gotenberg?

Gotenberg is a Docker-based API for converting documents to PDF. Trusted in production by thousands of companies. Also 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:8

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

⁠Features

• HTML, URL, Markdown to PDF via Headless Chromium
• Office documents to PDF via LibreOffice (100+ formats)
• Merge, split, rotate, flatten PDFs
• Watermark, stamp, encrypt PDFs
• PDF/A and PDF/UA compliance
• Screenshots of URLs and HTML
• Read/write metadata and bookmarks
• See the full documentation⁠.