How do I deploy Gotenberg on Railway?

You can deploy Gotenberg on Railway by clicking the "Deploy Now" button on this page. Railway will automatically set up all the necessary services and configurations for you.

What are the system requirements?

Railway handles all the infrastructure requirements. You only need a web browser to deploy and manage your application.

Is this template free to use?

Yes, this template is free to use within your existing Railway account.

Can I customize this template?

Yes, you can fully customize this template. After deployment, you will have full control of what you've deployed in your Railway project.

How do I get support for this template?

You can get support through our community forum: gotenberg-ae6a3c5c, or click "Get template help" for this template for more assistance.

Deploy and Host Gotenberg on Railway

Gotenberg is an open-source, Docker-based API that converts HTML, Markdown, and Office documents into PDFs using Chromium and LibreOffice. It provides a reliable, stateless service for server-side PDF generation, ideal for backend applications, automation workflows, and document pipelines.

About Hosting Gotenberg

Hosting Gotenberg involves deploying a stateless HTTP API that exposes endpoints for converting documents to PDF. Gotenberg runs as a single container and does not require a database or persistent storage, making it easy to deploy and scale. On Railway, you can run Gotenberg with minimal configuration, expose it via a public URL, and integrate it with services such as n8n, backend APIs, or serverless functions. Scaling is handled at the container level, allowing you to increase resources as demand grows without changing application logic.

Common Use Cases

Generating PDFs from HTML templates (invoices, quotes, reports)
Converting emails or web pages into downloadable PDF documents
Automating document generation in workflows (e.g. n8n, backend jobs)

Dependencies for Gotenberg Hosting

Docker-compatible runtime
Chromium (bundled with Gotenberg image)

Deployment Dependencies

Gotenberg Docker image https://github.com/gotenberg/gotenberg
Gotenberg documentation https://gotenberg.dev/docs/getting-started/introduction

Implementation Details

Example request to convert HTML to PDF:

POST /forms/chromium/convert/html
Content-Type: multipart/form-data

index.html:

The response will be a generated PDF file.

Why Deploy Gotenberg 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 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.