← Directory

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 3 of 9 platforms

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

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.

84/100 Excellent

Maintained
100last commit 8 days ago
Popular
8213,235 GitHub stars
Easy to install
553 install platforms, install notes, Docker image
Light to run
801 GB minimum RAM, runs on ARM

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

GitHub stars
13,235
Open issues
32
Last commit
2026-10-05
Latest release
v8.37.0
License
MIT
Activity
declining

Checked 7 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 15 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 15 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 9 days ago - public community threads