Analytics cookies only (Google Analytics, PostHog). No ad networks, no cross-site tracking. See our privacy policy.
Co
Self-host ConvertX
updated Nov 2026deployed by usprices checked · Jul 2026Install verified on Ubuntu 26.04 · Nov 2026 · how we test
We earn commissions when you shop through the links below. Full disclosure →
A self-hosted file converter with a web interface: upload one or more files, choose a target format and download the result. It wraps existing tools, including FFmpeg, ImageMagick, LibreOffice, Pandoc, Calibre, libvips, Inkscape and pdftops, and the README claims support for more than a thousand formats. Its feature list is conversion, batch processing, password protection and multiple accounts. It is a general file converter, not a PDF editor: there are no merge, split, sign or redact tools. A TypeScript app on Bun with a SQLite database.
Pick ConvertX when you want one self-hosted page that converts files between formats, PDF among them, and you do not need to edit PDFs. It is a general file converter: you upload files, choose a target format and download the result, with batch processing, password protection and multiple accounts. It wraps existing tools (the README table lists FFmpeg, ImageMagick, LibreOffice, Pandoc, Calibre, libvips, Inkscape, pdftops and others) and claims support for more than a thousand formats. The README's feature list has no merge, split, sign or redact tools, so it is not a PDF editor. It is AGPL-3.0 TypeScript running on Bun with a SQLite database. Our snippet follows the README's Compose file with the image pinned to ghcr.io/c4illin/convertx:v0.20.0 (released 2026-10-28), a JWT secret generated into `.env`, the process run as your own uid, and `HTTP_ALLOWED=true` so the login cookie works over plain http. The README gives no RAM minimum, so our 1024 MB floor is an estimate based on the converters it bundles. In the catalog, Stirling-PDF is a PDF toolbox with more than 50 tools including merge, split, OCR and sign, BentoPDF does the same work in the visitor's browser, and Gotenberg is an API for generating PDFs without a web interface; ConvertX is the one aimed at turning files from one format into another, not at working on a PDF's pages.
What you need
Any VPS with at least 1024 MB of RAM
A domain you control — most self-hosted setups need HTTPS in front of them
Paid link — we earn a commission if you shop through it.
Install
Run these commands on your server:
# ConvertX: self-hosted file converter (PDF is one of many formats; it is not a PDF editor). Adapted from the README docker-compose.yml, image pinned to v0.20.0; JWT secret generated, app process run as your own uid, HTTP_ALLOWED=true so login works over plain httpmkdir convertx && cd convertxmkdir dataecho "JWT_SECRET=$(openssl rand -hex 32)" > .envecho "PUID=$(id -u)" >> .envecho "PGID=$(id -g)" >> .envcat > docker-compose.yml <<'EOF'services: convertx: image: ghcr.io/c4illin/convertx:v0.20.0 restart: unless-stopped ports: - "3000:3000" environment: - PUID=${PUID} - PGID=${PGID} - JWT_SECRET=${JWT_SECRET} - HTTP_ALLOWED=true volumes: - ./data:/app/dataEOFdocker compose up -dtimeout 300 bash -c 'until curl -fsS -o /dev/null http://localhost:3000/healthcheck; do sleep 3; done'# → http://SERVER_IP:3000 (create the first account straight away; registration then stays closed because ACCOUNT_REGISTRATION defaults to false)
ConvertX's README and source flag these before you rely on it:
non-negotiableThe first visitor creates the account: the README says "Don't leave it unconfigured and open, as anyone can register the first account." After that, registration is off unless ACCOUNT_REGISTRATION is true, and the README warns never to expose the service to the internet with ALLOW_UNAUTHENTICATED or ACCOUNT_REGISTRATION set to true and to allow only users you trust.
non-negotiableLogin needs HTTPS or localhost: the README says to set HTTP_ALLOWED=true if you cannot log in over plain http, but its variable table says to "only set this to true locally", and the source marks the auth cookie secure unless it is set. Our snippet sets it so the server IP works over plain http; do that only on a private network and remove it once the service is behind HTTPS.
non-negotiableUploaded and converted files are deleted automatically: the README gives AUTO_DELETE_EVERY_N_HOURS a default of 24 and says to set 0 to disable. Uploads and results live under ./data, so mount it somewhere with room for large video or document jobs.
non-negotiableThe image is large: Docker Hub lists the amd64 image for this tag at about 1.5 GB, because it bundles the converters. The registry lists amd64 and arm64 builds.
non-negotiablePUID defaults to 0, so the app runs as root unless you set it; our snippet passes your own uid and gid. Conversions run those bundled tools on whatever users upload, and the README says to allow only users you trust. The project has published high-severity advisories for path traversal leading to arbitrary file write or deletion (CVE-2025-66449, CVE-2026-24741, CVE-2026-59976) and for CSRF (CVE-2026-59977), all fixed by 0.18.0 and so before this pin; keep it updated.
ConvertX used 40 MB of RAM at idle on GCP e2-standard-2 · Ubuntu 26.04 LTS · Docker 29.9.3 (first boot, measured Nov 2026). We list a minimum of 1024 MB.
Is the ConvertX install snippet verified?
The ConvertX install snippet is marked verified on Ubuntu 26.04 (Nov 2026).