Skip to content

TubeSync in Docker on a Synology NAS

New guide published11/03/2022
Updated with DSM7.1 Steps and Screenshots23/06/2022
Added new port settings and Docker Bridge Network23/07/2022

What is TubeSync?

To quote the devs:

TubeSync is a PVR (personal video recorder) for YouTube. Or, like Sonarr but for YouTube (with a built-in download client). It is designed to synchronize channels and playlists from YouTube to local directories and update your media server once media is downloaded.

If you are looking for a way to grab individual videos you can also try my YouTubeDL Material guide which can also sync channels.

Let’s Begin

In this guide I am going to take you through the steps to get TubeSync up and running in Docker on your Synology NAS.

In order for you to successfully use this guide please complete the two steps below first.

Downloading the Container

The GUI version of this guide will be pulling the Tubesync image from ‘dougebanks’ as he is pushing the latest image to the Docker Hub Registry. If you want to use the original image use the Docker Compose at the bottom of this guide.

Open up Docker within DSM and navigate to the ‘Registry’ tab, and search for ‘tubesync’ in the search box and download the version by ‘dougeubanks’

Setting up the container

In Docker click on the ‘Image’ tab, in the list of your containers select the image and click on ‘Launch’

You will be greeted with the Network screen, we will be using the ‘synobridge’ network we created earlier select it from the list and click Next.

General Settings

Next you will be greeted with the General Settings screen, this is where you can start specifying some of your preferences.

You can change the name of the container to anything you like, and you may want to enable Auto Restart as this will ensure the container starts automatically if you reboot your NAS.

You will also notice a Configure capabilities button — don’t change anything in here!

Next up we are going to click on the ‘Advanced Settings’ button, this will take you to a new window with a number of tabs which we are going to work through.


Next we are going to set up a couple of environment variables that docker will use to allow the container access to our files and folders.

Click the Add button, and fill in the following details as per the table/screenshot, you will need to do one at a time.

PUIDThe UID you obtained in the user setup guide
PGIDThe GID you obtained in the user setup guide
TZYour timezone
HTTP_USEROptional – if you want to have a username to login
HTTP_PASSOptional – add a password if you added a username

You do not need to set up anything on these tabs.

Press ‘Save’ to go back to the initial setup screen, then press ‘Next’

Port Settings

We won’t be changing any of the ports the container uses. You can repeat the ones shown on the right side of the settings page ‘Container Port’ onto the left side ‘Local Port’ once you have done this press ‘Next’.

Volume Settings

We can now move onto the Volume tab in which we will be specifying the directories where TubeSync will store its configuration files and where the video downloads will be stored.

Click on Add Folder, click on the ‘docker’ share and create a new sub-folder called ‘tubesync’ then select this.

Now add ‘/config’ to the ‘Mount path’ box

We now need to repeat this process adding the folders below one at a time. Your path settings should look like the table/screenshot below.

File/FolderMount path

Click on Next and you will be taken to an overall summary screen, just do a quick sanity check to make sure they are correct. If you want to launch the server immediately check the box and click on Done.

You should now be able to access the web interface via the IP of your NAS followed by the port 4848


Docker Compose

You can use the below code saved as tubesync.yml in the ‘/docker/tubesync’ share to do a much quicker setup than via the Synology UI. You will need to set up the folders as per the Volumes/Mounts section first. Ensure you change the variables to your own.

version: "3.8"
    container_name: tubesync
    restart: unless-stopped
      - /volume1/docker/tubesync:/config
      - /volume1/data/media/youtube:/downloads
      - TZ=Europe/London
      - HTTP_USER=OPTIONALUSERNAME #remove this line if not required
      - HTTP_PASS=OPTIONALPASSWORD #remove this line if not required
      - 4848:4848
    network_mode: synobridge
    restart: unless-stopped
sudo docker-compose -f /volume1/docker/tubesync/tubesync.yml up -d

Throw me some bits or buy me a coffee?

If you have found my site useful please consider pinging me a tip as it helps cover the cost of running the site, you can even buy me a coffee 🙂

Buy Me A Coffee
Doge / Ethereum / Bitcoin
Published inDockerSynology


  1. Grant112 Grant112

    Awesome. Thanks for making this. Do you find you like TubeSync over YouTubeDL Material? Which is better?

    • Dr_Frankenstein Dr_Frankenstein

      We had a similar discussion in Discord. Both work well, Tubesync is purely for getting local copies of channels, I still keep Material running for the quick grab of a single video from the url. You can’t really lose by running both

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed. – writing Synology Docker Guides since 2016 – Join My Discord!