---
title: "Deploy ConvertX file converter"
description: "Protected ConvertX conversion with persistent accounts and history."
category: "Other"
url: https://railway.com/deploy/convertx-file-converter
---

# Deploy ConvertX file converter

Protected ConvertX conversion with persistent accounts and history.

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

- **Creator:** Anton Orel's Projects
- **Category:** Other
- **Total deploys:** 1

## Template content

### ConvertX Gateway

- **Image:** caddy:2.11.4-alpine@sha256:5f5c8640aae01df9654968d946d8f1a56c497f1dd5c5cda4cf95ab7c14d58648
- **Start command:** `/bin/sh -ec 'password_hash="$(caddy hash-password --plaintext "$GATEWAY_PASSWORD")"; printf "%s\n" "$GATEWAY_CONFIG" | sed -e "s|__USERNAME__|$GATEWAY_USERNAME|g" -e "s|__PASSWORD_HASH__|$password_hash|g" -e "s|__UPSTREAM__|$UPSTREAM|g" >/tmp/Caddyfile; exec caddy run --config /tmp/Caddyfile --adapter caddyfile'`
- **Health check:** /healthz
- **Public domain:** Yes

### ConvertX

- **Image:** ghcr.io/c4illin/convertx:v0.18.0@sha256:b515b04bfd25298a5cdc775b2fcd48b9399bab658ce13e2598b65df1b16098c8
- **Health check:** /healthcheck

## Documentation

# Deploy and Host ConvertX on Railway

## About Hosting ConvertX

ConvertX is a self-hosted online file converter supporting more than one thousand source and target formats through FFmpeg, ImageMagick, LibreOffice, Pandoc, Calibre, and other bundled tools.

## Why Deploy ConvertX on Railway

Railway provisions a generated Basic Auth bootstrap boundary, a private converter, health checks, and 5 GB of persistent account and job storage. Parallel conversion is capped at two processes to keep a starter deployment predictable.

## Common Use Cases

- Convert documents, images, audio, and video in a browser.
- Keep sensitive file conversions off third-party converter sites.
- Share one protected conversion service with a small team.

## Dependencies for ConvertX Hosting

The template uses ConvertX, Caddy, and one Railway volume.

### Deployment Dependencies

- [ConvertX](https://github.com/C4illin/ConvertX) provides the UI, accounts, and conversion toolchain.
- [Caddy](https://caddyserver.com) protects the public bootstrap and application surface.
- [Railway](https://railway.com) provides private networking, generated credentials, and persistent storage.


## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — [Jul'26] 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-file-converter