Back to all templates
ConvertX logo

ConvertX

Development512MB+ RAM

Self-hosted online file converter that supports 1000+ formats (documents, images, audio, video)

developmentdevtoolsconvertxopen-sourceself-hosteddocker

Deploy ConvertX in 3 Steps

1

Connect Your VPS

Add your server credentials to Server Compass

2

Select ConvertX

Choose from our template library

3

Deploy & Configure

Fill in settings and click Deploy

No Docker knowledge required
Step-by-step deployment guide

Deploy ConvertX on a VPS with Server Compass

Use the ConvertX template in Server Compass to deploy a self-hosted online file converter web UI on your VPS, then verify the setup screen.

About 10 minutesBrowser verified
1
Step 1

Open the server Apps tab

Select the tutorial-vps VPS, open the Apps tab, and start a new app deployment. Keep sensitive server details hidden before capturing or sharing screenshots.

Server Compass Apps tab before creating a ConvertX app
2
Step 2

Choose an app template

Click New App and choose the template deployment path so Server Compass can load the built-in catalog.

Choosing to deploy an app from a Server Compass template
3
Step 3

Search for ConvertX

Use the template picker search to find ConvertX in the Server Compass template catalog.

Searching for ConvertX in the Server Compass template picker
4
Step 4

Select the ConvertX template

Choose the ConvertX template. Server Compass fills the ConvertX web service, persistent data volume, generated JWT secret, and public web port.

ConvertX template selected in Server Compass
5
Step 5

Review the ConvertX settings

Confirm the app name and compose service. In this run, the app was named convertx-demo and used host port 4038.

Reviewing ConvertX project settings and compose service
6
Step 6

Deploy ConvertX

Review the generated compose settings, confirm the ConvertX web port is available, and click Deploy.

Reviewing ConvertX web port before deployment
7
Step 7

Watch the deployment progress

Keep the deployment modal open while Server Compass uploads the compose file, pulls the ConvertX image, starts the container, and verifies the stack.

Server Compass deploying the ConvertX template on the VPS
8
Step 8

Confirm ConvertX is running

After deployment finishes, return to the Apps tab and confirm the ConvertX app is marked Running with its application URL available.

ConvertX template running in the Server Compass Apps tab
9
Step 9

Open ConvertX in the browser

Open the application URL in a browser. The ConvertX setup or main page confirms the online file converter web UI is reachable.

The deployed ConvertX web UI loaded in a browser

After ConvertX Opens

  • Place ConvertX behind HTTPS before storing or sharing real files.
  • Change the generated admin password immediately after first login.
  • Disable account registration after creating the first admin account.
  • Back up the ConvertX config volume because it stores provider settings and the database.
  • Put ConvertX behind HTTPS before uploading private files.
  • Upload a small test file before using ConvertX with production documents.
  • Keep the ConvertX image updated for dependency and security fixes.

Verified Result

The ConvertX web interface loaded successfully from the deployed container.

ConvertX deployment questions

What does the ConvertX template deploy?

It deploys the ConvertX online file converter web UI with persistent data volume.

Which port did the tutorial use?

The tutorial used host port 4038, which maps to the ConvertX web UI on container port 3000.

Does ConvertX need setup after deployment?

Yes. Create the first account, then disable registration if desired.

Should this become a blog post?

No. The deployment guide should live on the ConvertX template detail page and be linked from the reusable template deployment docs page.

After Deployment

After deploying ConvertX with Server Compass, complete these steps to finish setup

1

Visit the application URL

2

Create the first account (becomes admin)

3

Set ACCOUNT_REGISTRATION=false and redeploy if needed

4

Upload and convert files

Need help? Check out our documentation for detailed guides.

ConvertX FAQ

Common questions about self-hosting ConvertX

How do I deploy ConvertX with Server Compass?

Simply download Server Compass, connect to your VPS, and select ConvertX from the templates list. Fill in the required configuration and click Deploy. The entire process takes under 3 minutes.

What are the system requirements for ConvertX?

ConvertX requires a minimum of 512MB RAM. We recommend a VPS with at least 1024MB RAM for optimal performance. Any modern Linux server with Docker support will work.

Can I migrate my existing ConvertX data?

Yes! Server Compass provides volume mapping that allows you to import existing data. You can also use standard ConvertX backup and restore procedures.

How do I update ConvertX to the latest version?

Server Compass makes updates easy. Simply click the Update button in your deployment dashboard, and the latest ConvertX image will be pulled and deployed with zero downtime.

Is ConvertX free to self-host?

ConvertX is open-source software. You only pay for your VPS hosting (typically $5-20/month) and optionally Server Compass ($29 one-time). No subscription fees or per-seat pricing.

Ready to Self-Host ConvertX?

Download Server Compass and deploy ConvertX to your VPS in under 3 minutes. No Docker expertise required.

Download Server Compass