# gotenberg/gotenberg

A developer-friendly API for converting many document formats into PDF files, and more!

Repository: https://github.com/gotenberg/gotenberg
Canonical: https://ross.abutalabs.com/products/gotenberg
Homepage: https://gotenberg.dev
Language: Go
License: MIT
License Family: permissive
Topics: api, wkhtmltopdf, unoconv, docker, puppeteer, pdftk, libreoffice, chromium, chrome, convert-to-pdf, exiftool, openoffice, qpdf, docx-to-pdf, html-to-pdf, pdf, pdf-converter, screenshots, excel, word
Last push: 2026-08-21T09:58:03+00:00

## Health v2 (maintenance only)
Score: 98/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 98, release rhythm 98, longevity 100
- inputs: {"age_days": 3085, "days_push": 12, "days_rel": 19, "gap_med": 11, "n_releases_24m": 44}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 12942, forks 846 (observed 2026-08-28T04:11:00.195848+00:00)

## What it is
Gotenberg is a Docker-based HTTP API for converting documents (HTML, URLs, Markdown, Office files) into PDFs using headless Chromium and LibreOffice. It also provides PDF manipulation endpoints for merging, splitting, encrypting, watermarking, metadata, and PDF/A compliance.

## Use cases
- convert docx to pdf via api
- render html or url to pdf
- convert excel spreadsheets to pdf
- merge and split pdf files programmatically
- generate pdf/a compliant documents
- screenshot web pages as images
- watermark or encrypt pdfs
- produce factur-x e-invoices

## When to choose
- you need a self-hosted, production-grade document-to-PDF conversion service
- you want to avoid managing Chromium, LibreOffice, and fonts yourself
- you need PDF post-processing like merge, split, encryption, or metadata in one API
- your stack can call an HTTP API from any language

## When to avoid
- you need a lightweight in-process library rather than a Docker service
- you cannot run containers in your environment
- you need pixel-perfect conversion of complex Office documents beyond LibreOffice's fidelity
- you only need simple PDF generation without conversion

## Facets
- artifact type: service
- maturity: stable
- function: http-server, pdf, image-processing, web-scraping
- domain: pdf, files, web-development, developer-tools, self-hosted
- platform: self-hosted, go
- tags: pdf-conversion, document-conversion, headless-chromium, libreoffice, pdf-manipulation, screenshots, pdfa, e-invoicing, docker-based-api, docker, web-server, linux

## Member repositories
- gotenberg/gotenberg (main) score 98

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:00.195848+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:13:40.261689+00:00, confidence not recorded.
  - readme: https://github.com/gotenberg/gotenberg (fetched 2026-08-28T04:11:00.195848+00:00, sha c197626db3b0)
  - homepage: https://gotenberg.dev (fetched 2026-08-29T08:09:37.253456+00:00, sha 53db49bf8378)
  - site_page: https://gotenberg.dev/docs/getting-started/introduction (fetched 2026-08-29T08:09:37.263212+00:00, sha 28ffa8fd49b0)
  - site_page: https://gotenberg.dev/docs/getting-started/routes (fetched 2026-08-29T08:09:37.265453+00:00, sha 22858e12cced)
  - site_page: https://gotenberg.dev/docs/configuration (fetched 2026-08-29T08:09:37.267288+00:00, sha 1a631c25acb5)
- Data as of 2026-08-30T08:39:29.467469+00:00.