Deploy and Host Gotenberg on Railway

Gotenberg is a stateless API for converting HTML, Markdown, URLs and Office documents to PDF, and for merging, splitting and transforming PDFs, using Chromium and LibreOffice.

About Hosting Gotenberg

This template runs the official gotenberg/gotenberg:8 image on port 3000, started with basic authentication enabled so the converter is not open to the internet. The username and password are generated at deploy time: find GOTENBERG_API_BASIC_AUTH_USERNAME and GOTENBERG_API_BASIC_AUTH_PASSWORD in the service's Variables tab. Send them with every request, for example curl --user USER:PASSWORD --form url=https://example.com https://YOUR-DOMAIN/forms/chromium/convert/url -o out.pdf. There is no web interface; the API is documented at gotenberg.dev.

Common Use Cases

Generate invoices and reports as PDF from HTML templates
Convert Word, Excel and PowerPoint files to PDF
Merge, split and watermark PDFs from your own services

Dependencies for Gotenberg Hosting

One service; nothing else (no volume needed, it is stateless)

Deployment Dependencies

Why Deploy Gotenberg on Railway?

Railway gives you a public HTTPS URL and private networking, so your other Railway services can call Gotenberg internally, with no server to maintain.