Install Convertx on a Synology NAS with Docker

Effortlessly streamline your media conversion workflow with Convertx—a modern solution designed for efficiency and simplicity. Whether you’re managing a diverse library of files or bridging format gaps, Convertx offers an intuitive platform to meet your needs.

Why Choose Convertx?

Convertx brings cutting-edge features to the table:

• Efficient Media Conversion: Quickly process and convert media files into desired formats.
• Enhanced Security: Includes JWT token authentication for secure operations.
• HTTP API Support: Easily integrate with other tools for seamless automation.
• Dockerized Simplicity: Lightweight and flexible, Convertx runs perfectly in Docker environments.

Take control of your media management process with Convertx—a tool designed to make your life easier. Start using Convertx today and experience the future of media conversion!

You can find the Official site here.

---

Create Share Folder

1. Log in to your Synology NAS
   Access your Synology NAS using your web browser and enter the login credentials.

2. Open the Main Menu
   In the top-left corner, click on the Main Menu (the icon with squares).

3. Navigate to File Station
   In the Main Menu, locate and click on File Station to open the file management tool.

4. Go to the Docker Folder
   In the left sidebar of File Station, find your Docker folder or navigate to the location where you store Docker-related files (you may need to create one if it doesn’t exist).

5. Create a New Folder
   At the top of File Station, click on Create.
   Select Create Folder from the dropdown menu.
   Name the folder convertx. Press OK to create the folder.

Now, you have a Convertx folder in the Docker directory, where you can store configuration files or other relevant data for your setup.

---

Setting up Task Scheduler

1. Log in to your Synology NAS.
2. Navigate to the Main Menu and open the Control Panel.
3. Scroll down and locate Task Scheduler, then click to open it.

4. In the top menu bar, click Create, select Scheduled Task, and choose User-defined Script.

5. In the window that appears:
   • Enter a task name. This can be anything, such as the name of the app you’re installing. It doesn’t need to be specific. Convertx will be fine.
   • For User, select root from the dropdown menu.
6. Click on the Schedule tab at the top:
   • Select Run on the following date and leave the Start time and Repeat options at their default values.
7. Next, click the Task Settings tab:
   • Ignore the Notification section.
   • Under Run command, paste your docker run command. Double-check to ensure all file paths and parameters are correct.

Docker Run Code

docker run -d \
  --name convertx \
  --restart unless-stopped \
  -p 3000:3000 \
  -e JWT_SECRET=aLongAndSecretStringUsedToSignTheJSONWebToken1234 \ # will use randomUUID() if unset
  -e HTTP_ALLOWED=True \
  -v /volume1/docker/convertx:/app/data \
  ghcr.io/c4illin/convertx

Please double-check your paths. You can also change the port number if required. Remember to visit the official guide as there may be extra features you can enable. Official Guide

8. Click OK to save the task. You’ll be prompted to enter your Synology NAS password—enter it and press Submit.
9. Back in the List of tasks, locate the task you just created.
10. Select the task, then click Run from the top menu. When prompted to confirm, click OK.

Your task will now execute, setting up your Docker container. This process may take several minutes. You can now open your container by visiting:

yournasipaddress:3000. Convertx should now be up and running!

If you can’t login, make sure you are accessing the service over https or keep set HTTP_ALLOWED=true.

---

Docker Compose Code

If you’re comfortable with Docker Compose, you can use the following configuration to set up the installation for Convertx.

version: "3.8"
services:
  convertx:
    image: ghcr.io/c4illin/convertx
    container_name: convertx
    restart: unless-stopped
    ports:
      - "3000:3000"
    environment:
      JWT_SECRET: aLongAndSecretStringUsedToSignTheJSONWebToken1234 # will use randomUUID() if unset
      HTTP_ALLOWED: "True"
    volumes:
      - /volume1/docker/convertx:/app/data

docker-compose up -d

Thanks for reading! 🎉🤘🎶

Need more inspiration? Check out our other articles and level up your knowledge. 🔥📖💡

If you enjoy the site, feel free to tip me.