Deploy and Host ConvertX on Railway

ConvertX is a self-hosted online file converter. It converts between more than a thousand formats using FFmpeg, LibreOffice, Pandoc, ImageMagick, libvips, Inkscape, Calibre and other tools, with batch conversions, per-user history and automatic cleanup. It is a private alternative to online converter websites, so your files never leave your server.

About Hosting ConvertX

This template runs the official c4illin/convertx:v0.18.0 image as one service. ConvertX makes the first account an admin, so on first boot a script registers CONVERTX_ADMIN_EMAIL with a generated password; with registration off, nobody else can sign up, and downloads need a login. Accounts, history and converted files live on a Railway volume at /app/data, and files older than 24 hours are deleted automatically. The image is large (about 1.5 GB) because it bundles the converters, so the first deploy takes a few minutes. Video conversion is CPU-heavy; the Hobby plan works for documents and images.

Common Use Cases

Converting documents between Word, PDF, Markdown and HTML
Resizing and converting images and videos without uploading them to third-party sites
Converting e-books between EPUB, MOBI and PDF

Dependencies for ConvertX Hosting

c4illin/convertx:v0.18.0 (official image)
A Railway volume at /app/data

Deployment Dependencies

Implementation Details

Service	Source	Networking	Storage
convertx	`c4illin/convertx:v0.18.0`	public domain on 3000	volume at `/app/data`

Variable	Default	Purpose
`CONVERTX_ADMIN_EMAIL`	`admin@example.com`	Account created on first boot
`CONVERTX_ADMIN_PASSWORD`	generated	Its password
`ACCOUNT_REGISTRATION`	`false`	Blocks further sign-ups
`AUTO_DELETE_EVERY_N_HOURS`	`24`	Deletes old files; `0` keeps them
`JWT_SECRET`	generated	Signs sessions

Notes:

Set ACCOUNT_REGISTRATION=true to let others create accounts.
The seed only runs while no account exists.

This is a community-maintained deployment package and does not imply affiliation with or endorsement by the ConvertX project.

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