Gotenberg

Gotenberg is a developer-friendly API for converting HTML, Markdown, and Office documents into PDFs using Chromium and LibreOffice.

  • Other
  • Productivity
  • Tools & Utilities
Gotenberg is a developer-friendly API for converting HTML, Markdown, and Office documents into PDFs using Chromium and LibreOffice. It is pre-configured for Paperless-ngx, making it a practical option for self-hosted document pipelines.

Platform availability

Available on 4 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox
  • Helm
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

85/100 Excellent

Maintained
100last commit 23 days ago
Popular
8313,476 GitHub stars
Easy to install
654 install platforms, install notes, Docker image
Light to run
801 GB minimum RAM, runs on ARM
Security check
79no serious findings, CI, tests, OpenSSF Scorecard 4.8/10

Availability: platform listings confirmed today, links checked 11 days ago

GitHub stars
13,476
Open issues
28
Last commit
2026-10-29
Latest release
v8.39.0
License
MIT
Activity
declining

Checked 23 days ago - source: GitHub (gotenberg/gotenberg)

Resources & Compatibility

Minimum requirements: 1 GB RAM, 2 CPU core(s), 1 GB disk. ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Expose the Gotenberg API on port 3000 Start Gotenberg with -p 3000:3000 so its HTTP API is reachable from your host or other apps. All PDF/HTML conversion requests are sent to this port, so if it is not published the service will not be usable. source

Fetched 54 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

How do I change Gotenberg settings when running it in Docker?

Configure it with CLI flags or environment variables by overriding the Docker image's default command.

Which port should I expose for the Gotenberg API?

Expose port 3000, for example with -p 3000:3000, because conversion requests are sent to this HTTP API.

Can Gotenberg convert Microsoft Word files?

Yes, it converts Word, Excel, PowerPoint, and 100+ other formats to PDF using LibreOffice.

How do I wait for JavaScript-heavy pages to finish before creating a PDF?

Use options to wait for network idle, JavaScript expressions, or specific DOM selectors before rendering SPAs.

How can I confirm a restored Gotenberg setup works?

Recreate Gotenberg on another host and verify custom fonts, templates, and command flags reproduce known document page counts.

Where should I look if a conversion problem is not documented?

Check the GitHub issues and discussions, or open a new issue.

Answers sourced from dockup.ai, github.com, gotenberg.dev, gotenberg.dev, gotenberg.dev

Community

Collected 48 days ago - public community threads