Deploy and Host Gotenberg Production on Railway

Gotenberg is a Docker-based API for converting web pages and office documents into PDFs. It bundles Chromium, LibreOffice, and PDF engines for rendering HTML, Markdown, Word, Excel, PowerPoint, and more. This template deploys the official image with private networking, generated Basic Auth credentials, healthchecks, and production-oriented defaults.

About Hosting Gotenberg Production

Hosting Gotenberg Production on Railway gives you a ready-to-use PDF conversion service without building or maintaining a custom image. This template deploys the official gotenberg/gotenberg:8 image as a single stateless service, keeps the API private by default, and configures generated Basic Auth credentials for clients that later expose it publicly. Chromium and LibreOffice start with the container to avoid first-request cold starts, while Railway checks /health before a deployment becomes active. Request timeouts, graceful shutdown, structured JSON logs, and restart behavior are preconfigured. No database, volume, or external service is required.

Common Use Cases

• Generating invoices, quotes, reports, and other PDFs from HTML or Markdown.
• Converting Word, Excel, PowerPoint, and other office documents into PDFs.
• Merging, splitting, encrypting, watermarking, and processing PDFs in automated workflows.

Dependencies for Gotenberg Production Hosting

• Official gotenberg/gotenberg:8 Docker image (configured automatically).
• No database or persistent storage required.
• Optional public HTTPS domain for access outside Railway’s private network.

Deployment Dependencies

• Gotenberg
• Gotenberg Documentation
• Routes Overview

Implementation Details

This template runs the full official Gotenberg image on port 3000 and uses /health as the deployment healthcheck. Services in the same Railway environment can connect through private networking. Basic Auth is enabled with the username gotenberg and a generated password. To make the API available from the internet, add an HTTP proxy or domain targeting port 3000 and use the same credentials.

Why Deploy Gotenberg Production on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Gotenberg Production on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.