Install ConvertX Inside Docker Container on Linux

ConvertX is a file conversion service, designed to run on the own server or device. It supports conversion of over 1,000 file formats - documents, images, audio, video, archives, etc. Great for users who want to convert files privately on their own device.

This tutorial explains how to install ConvertX inside a Docker container on the Linux. Commands have been tested on Ubuntu.

Prepare environment

Make sure you have installed Docker in your system. If you are using Ubuntu, installation instructions can be found in the post.

Install ConvertX

• Host network

Run the following command to create a container for ConvertX that uses host network:

docker run -d --name=convertx --restart=always --network=host \
    -v /opt/convertx/data:/app/data \
    -e HTTP_ALLOWED=true \
    c4illin/convertx

• User-defined bridge network

User-defined bridge network can be used for listening on different port. By default, ConvertX service is listening on port 3000. It can be changed with -p option.

docker network create app-net

docker run -d --name=convertx --restart=always --network=app-net \
    -p 8080:3000 \
    -v /opt/convertx/data:/app/data \
    -e HTTP_ALLOWED=true \
    c4illin/convertx

Testing ConvertX

Open a web browser and go to http://<IP_ADDRESS>:3000, replacing <IP_ADDRESS> with your system's actual IP address. The first time you visit, you'll be asked to create an account. After that, you’ll be taken to the web application.

Uninstall ConvertX

To completely remove ConvertX, remove its container:

docker rm --force convertx

Remove ConvertX image:

docker rmi c4illin/convertx

You can also remove ConvertX data:

sudo rm -rf /opt/convertx

If a user-defined bridge network was created, you can delete it as follows:

docker network rm app-net