Analytics cookies only (Google Analytics, PostHog). No ad networks, no cross-site tracking. See our privacy policy.
Go
Self-host Gotenberg
updated Nov 2026deployed by usprices checked · Jul 2026Install verified on Ubuntu 26.04 · Nov 2026 · how we test
We earn commissions when you shop through the links below. Full disclosure →
A Docker-based API for PDF work: send files as multipart/form-data and get a PDF back. It converts web pages, HTML and Markdown through headless Chromium and more than 100 office formats through LibreOffice, and it can merge, split, stamp, sign, encrypt and optimise PDFs or make them PDF/A and PDF/UA. There is no web interface and no state between requests, so it is a building block for your own applications rather than a tool you click through.
Pick Gotenberg when your own application needs to produce PDFs and you would rather call an API than manage Chromium, LibreOffice and fonts yourself: you send files as `multipart/form-data` and get a PDF back. It converts URLs, HTML and Markdown through headless Chromium and office documents through LibreOffice, and it can merge, split, stamp, sign, encrypt and make PDF/A or PDF/UA files. The code is MIT-licensed Go. There is no web interface and no accounts, so it is a service for developers, unlike the catalog's Stirling-PDF, BentoPDF and PDFding, which are tools you open in a browser; Stirling-PDF also has a REST API but is built around its UI. Our snippet is the project's Docker Compose pattern with the image pinned to `9.1.0` (released 2026-11-06) and the port bound to `127.0.0.1`, as the docs advise. The Kubernetes section of the install page asks for at least 512Mi of memory, which is the source of our 512 MB floor.
What you need
Any VPS with at least 512 MB of RAM
A domain you control — most self-hosted setups need HTTPS in front of them
Paid link — we earn a commission if you shop through it.
Install
Run these commands on your server:
# Gotenberg — based on the project's install docs (Docker Compose), pinned to 9.1.0cat > docker-compose.yml <<'EOF'services: gotenberg: image: gotenberg/gotenberg:9.1.0 restart: unless-stopped ports: - 127.0.0.1:3000:3000EOFdocker compose up -dtimeout 180 bash -c 'until curl -fsS -o /dev/null http://localhost:3000/health; do sleep 3; done'# → API only, no web UI, bound to 127.0.0.1 as the docs advise: POST files to http://localhost:3000/forms/chromium/convert/html or /forms/libreoffice/convert (front it with an authenticating proxy before exposing it)
Gotenberg's install and operations documentation flag these before you rely on it:
non-negotiableIt does what its callers ask: it loads the URLs they name, runs the scripts of the pages it prints and opens their documents, with no credentials required and access to any address its network reaches. The docs say to keep it off the public network. If untrusted users can send requests, enable basic auth with API_ENABLE_BASIC_AUTH or OIDC, serve HTTPS, and restrict outbound requests.
non-negotiableOur snippet publishes the port on 127.0.0.1 only. Other hosts and containers cannot reach it until you change that, and the documentation says Docker otherwise publishes the port on every network interface.
non-negotiableEach request has a 30-second timeout by default, queue time included, and a slower conversion answers 503. Request size and queue length have no limit by default. One container runs one Chromium (up to six pages at once) and one LibreOffice (one document at a time), and the engines restart every 100 and every 10 conversions to bound memory. To serve more, run more containers.
non-negotiableThe first request starts the engine it needs and pays the start-up cost unless you set CHROMIUM_AUTO_START and LIBREOFFICE_AUTO_START. The /debug route that prints every flag is off by default and should stay off. Version 9 is a major release with changed routes and flags, and the 8 tag remains available, so read the upgrade guide before moving a client written for 8.
Gotenberg used 9 MB of RAM at idle on GCP e2-standard-2 · Ubuntu 26.04 LTS · Docker 29.9.3 (first boot, measured Nov 2026). We list a minimum of 512 MB.
Is the Gotenberg install snippet verified?
The Gotenberg install snippet is marked verified on Ubuntu 26.04 (Nov 2026).