Deploy and Host ConvertX on Railway

ConvertX is a self-hosted online file converter supporting over 1,000 different formats. Built with TypeScript, Bun, and Elysia, it features multi-file processing, password protection, and support for multiple user accounts.

About Hosting ConvertX

Deployment Steps

After the app is deployed, click on the ConvertX deployment and then click on the pre-generated URL.
You should see a “Welcome!” page — create an account to finish deployment!

If you see a Railway error page instead, it's likely Railway hasn't automatically added the port to your domain. Go to Settings → Networking, click the Edit button next to the domain and click "edit port", then select or enter port 3000.

If you wish to use a custom domain, you simply need to click on the deployment, go to Settings → Networking and click on the + Custom Domain button. Enter your domain and select or enter port 3000.

Post-Deployment Steps

The first account created has admin privileges, so create it immediately after deployment to secure your instance.

All data is stored in the attached volume, so keep an eye on usage. If the volume becomes full, you may run into errors. You can adjust the size of the volume, or reduce the AUTO_DELETE_EVERY_N_HOURS environment variable.

Dependencies for ConvertX Hosting

Deployment Dependencies

Service	Version	Purpose	Source Image
ConvertX	latest	Main application	ghcr.io/c4illin/convertx
SQLite	Built-in	User data and history	Included in image
Multiple Converters	Various	File conversion engines	Bundled in Docker image

Environment Variables

Take a look at the GitHub repository for an up-to-date list of supported environment variables.

Resource Requirements

Requirements can vary wildly depending on users and usage; converting a small image will have minimal impact compared to converting videos.

Troubleshooting

For common issues and community support, visit the Railway Community Forum.

Template Changelog

23 July, 2025

Initial template release

Common Use Cases

Universal Format Freedom: Break free from format limitations - convert documents, images, videos, and more without installing dozens of applications
Team Asset Pipeline: Standardize file formats across your organization for seamless collaboration and workflow automation
Digital Library Management: Transform your e-book collection between formats, making your content accessible on any device
Batch Media Processing: Convert entire folders of images or videos at once, perfect for photographers and content creators

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 get a powerful file conversion service with automatic HTTPS, easy scaling, and persistent storage - all without managing servers. Host your servers, databases, AI agents, and more on Railway.