---
title: "Deploy ConvertX"
description: "ConvertX 0.18: convert files between 1000+ formats in your browser."
category: "Other"
url: https://railway.com/deploy/convertx-1
---

# Deploy ConvertX

ConvertX 0.18: convert files between 1000+ formats in your browser.

**[Deploy ConvertX on Railway](https://railway.com/template/convertx-1)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/convertx-1/manifest.json

- **Creator:** Agaz Self-Host
- **Category:** Other

## Template content

### convertx https://raw.githubusercontent.com/C4illin/ConvertX/v0.18.0/public/apple-touch-icon.png

- **Image:** c4illin/convertx:v0.18.0
- **Start command:** `sh -c 'printf "%s\n" "$CONVERTX_SEED" > /tmp/seed.mjs; bun run dist/src/index.js & pid=$!; trap "kill -TERM $pid; wait $pid; exit 0" TERM INT; bun /tmp/seed.mjs & wait $pid'`
- **Health check:** /healthcheck
- **Public domain:** Yes

## Documentation

# 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

- [ConvertX on GitHub](https://github.com/C4illin/ConvertX)
- [ConvertX v0.18.0 release](https://github.com/C4illin/ConvertX/releases/tag/v0.18.0)
- [Railway volumes](https://docs.railway.com/reference/volumes)

### 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.


## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — A Self-Hosted & Modern Roleplaying Platform
- [Letta Code Remote](https://railway.com/deploy/letta-code-remote) — Run a Letta Code agent 24/7. No inbound ports, just deploy.

Open this page in a browser: https://railway.com/deploy/convertx-1