Skip to content

Setting up Couchpotato in Docker on a Synology NAS

Updated for DSM6 and the latest version of Docker 19/11/2016

In the guide I will be taking you through the steps to download and setup Couchpotato in Docker on a Synology NAS, this makes some assumptions that you know your way around the DSM interface.

Downloading the Images

The first thing we are going to do is download the Couchpotato image from within Docker, you will need to navigate to the Registry tab and within the search box at the top of the panel enter ‘Couchpotato’ this will then list all the images available. You need to select the version made by Linux| and click on ‘download’


The image will begin to download in the ‘image’ tab you can track its progress until the download completes.



In the previous versions of these guides I used a long winded approach to getting your ID information, I have since found a much easier approach.

You will need to SSH into your Diskstation using ‘Putty’ or an equivalent program.

Open up Putty, the only thing you need to enter is the IP address of your NAS and select the SSH radio button.


Click on open, you will get a prompt asking if you trust the key, if this is the first time you have used SSH, just press OK or accept.

Enter the login information for you Synology user account, you will not be able to see the password as you type it, I use a very long one so I just paste it in from my password manager. (right click acts as paste in putty)

Once logged in type ‘id’ without the quotes and this will show your UID(aka PUID) which in my case is 1026 and the GID(aka PGID) which is 101 for an administrator


Setting up Couchpotato

Head into the ‘image’ tab and select the Couchpotato image, then click on Launch, you will be greeted with the first step of the setup.

I am not making any changes as I do not need to limit the resources on my 1815+ as I have 6GB of RAM, just go straight into ‘Advanced Settings’.


Tick the ‘Enable Auto Restart’ this will ensure the container starts up automatically if you reboot.


Then click on volumes, we are now going to set up the shares we want to mount. Couchpotato needs access to your Downloads, Config and Movies folders.

Under the ‘Docker’ share on your Diskstation create a folder called ‘NZBGet’ this is important as your configuration files will be stored here. We do the same thing for all the other guides.

And then also add each of your other folders. It should look like the screenshot below.


Next click on Port Settings, we can now setup which port we want to use for Couchpotato, by default the local port will say ‘Auto’ we need to change this to our own value otherwise the port will change every time you restart. In this case I am using 32877 but you can choose anything you want. This effectively port forwards to the container port of 5050.

Environment Variables (PGID and PUID)

Next we are going to setup a couple of environment variables this is the user details we took note of earlier so the Docker image has the right access to the shares we just created.

In the environment tab enter the details as shown in the screenshot, but change them to whatever yours were noted as.

We are pretty much ready to roll now, click on OK and you will be taken back to the overview screen we saw earlier. Click next and tick the box that says ‘Run this container after the wizard finishes’ and click Apply


Now just open up your browser and navigate to the IP address of your NAS and the port number you assigned and if you have done everything right you will be greeted by Couchpotato… On the first run you will need to give it a minute or so to start.

If you have any questions or problems feel free to let me know in the comments.

Published inDockerSynology


  1. Bob Bob

    I want to thank you so much for putting this together! I set up couchpotato last night and everything went great. I was able to log on and get it configured.

    This morning I logged in and made the last of my changes to the CP config, restarted it, and now haven’t been able to log in.

    I have no idea what happened. I realize you are not a help desk, lol, but if you have any ideas I would appreciate them.

    For the time being I think I’m going to delete the container and CP, then start from scratch.


    • Bob Bob

      I’m at a complete loss as to what’s going on. I deleted the couchpotato container and redid everything this morning and It was working great.
      CP snatched some movies and sent them to sabnzbd.
      Sabnzbd showed them as completed and moved to the Movies folder.
      The movies were not in the movie folder though.
      I went to go into CP and now I cant get in. I get an “unable to connect” message. This is the same thing that happened the other day. I set it up exactly the same as you have listed here.
      I can get into sonarr and sabnzbd just fine.

      Any help you could give me would be fantastic. Thank you,

      • Dr_Frankenstein Dr_Frankenstein

        This is very peculiar behavior, are you sure you are using the correct port number + make sure you are not using https://

        Is the container running and is there anything showing in the logs as to errors

  2. Vidkun Vidkun

    Great guides! Thanks a lot!

    Would love to see one for nzbget and emby server as well if you’re up for it. I’ve been struggling with those last two the past few days.

    • Dr_Frankenstein Dr_Frankenstein

      I have just figured out NZBGet so this will be up at some point today, I will check out what docket images are available, was there a specific Emby one you were trying as I could base the guide around that.

      • Vidkun Vidkun

        I think I got nzbget working with the linuxserver/nzbget image. As for Emby, I’m using the official image.

        I was able to get Emby up and running, config is persistent across reboots, was able to add my media share to the library and it pulled in the initial items that were in there (in process of migrating to the synology). However, it won’t pick up new items and seems to just be having sporadic issues reading any of it. It almost seems like a permissions issue on the shares, but from what I can tell the permissions are all good to go.

  3. kwartet kwartet

    First of all I want to thank you for your wonderful guides. They helped me a lot to get me up and running.
    There is a small mistake in the section “Environment Variables (GUID and PUID)”
    I suspect the tile should contain GPID and PUID, as per your screenshot and other guides, instead of GUID and PUID.

    This was confusing for me at first.

    • Dr_Frankenstein Dr_Frankenstein

      Good spot I will get them amended, I suspect it’s where I pulled the posts from a backup which was prior to making some edits. I need to amend the method for obtaining the IDs as you can just run a command directly via SSH.

  4. Tim Veluwenkamp Tim Veluwenkamp

    How can I use the synology download station with the docker container? Blackhole isn’t accepting magnet links 🙁

    • Dr_Frankenstein Dr_Frankenstein

      I have not tried using Couch with Download Station or torrents for that matter so I am not sure how it usually works, does it not just pass the links straight off to the interface?

      • TimVNL TimVNL

        Blackhole Doesn’t support magnet….. Using Transmission in a container now instead of Download Station and it works like a charm

        2 other qeustions do:

        1. Does couchpotato autoupdate
        2. how far can I limit the memory?

        Awesome guide do also used it as base for installing transmission and sickrage 🙂

        Keep up the good work.

  5. GC GC

    I did step by step and am unable to get to the Couchpotato page using eithe rthe 5050 or 5053 (Tried installing it twice). Now when I try and go back and unistall everything (including docker) I can’t install the Custom Version of Couchpotato from the app’s page since it says that the port is in use.

    • Dr_Frankenstein Dr_Frankenstein

      Did you change the port numbers for the container to something other than 5050 and 5053?

      • GC GC

        I tried 5050 first and 5053 the second time. I can’t access it from either port.

        • Dr_Frankenstein Dr_Frankenstein

          Can you post what you have put in the port settings for the local and container ports.

  6. GC GC

    Local Port 32771
    Container Port 5053 Type TCP

    • Dr_Frankenstein Dr_Frankenstein

      OK you just need to connect to port 32771 so NAS.IP:32771 and you should get the setup screen.

      • GC GC

        I tried that, still not letting me see the log in screen, and I did a port scan and boty 5053 and 32771 are open.

        • Dr_Frankenstein Dr_Frankenstein

          I will run back through the guide to see if something needs to be changed as I know the Docker UI has moved around a bit

  7. Dr_Frankenstein Dr_Frankenstein

    I will ping you an email it will be a bit easier than using the comments…

    • Heath Heath


      I’m having a similar issue also. Your guides have been amazing and have helped me get docker, sonaar, and nzbget all setup and working. I’m trying to get couchpotato up and running and cannot access it using NAS.ip:32877

      thanks for any help

      • Dr_Frankenstein Dr_Frankenstein

        Hi, glad they have been useful. What internal port are you using? Have you tried just using the same port 5050 for both the internal and external.

  8. DNA DNA

    Thanks a lot, it really helped me! Especially the environments variables information, which is not described in the source git repository.

  9. BiggerDiggler BiggerDiggler

    First off, thank you for these guides. Huge help for me as a docker newbie.

    Secondly, hoping you can help. I followed the instructions but CouchPotato is not seeing my folders in the Renamer settings.

    The folder I use for completed movies that are awaiting renaming & moving is:
    and I’ve set that up with a mount path value of:

    The folder I use for renamed movies (and that Plex looks at) is:
    and I’ve set that up with a mount path value of:

    Am I doing that right? Also looks like there was some confusion above in your instructions on whether to call it GUID, GPID, or PGID in the environment settings. Mine is set to PGID, just like I setup NZBGet.

    • BiggerDiggler BiggerDiggler

      I got it figured out. I removed that container and relaunched it using the Shared Folder as the path, so “/volume1/Downloads/” instead of “/volume1/Downloads/Complete/Movies/” and then in the CP settings I saw that I should be looking for the /movies folder instead of trying to navigate to /volume1. A bit confusing for a docker newbie, but I think I get what it’s trying to do.

      • Dr_Frankenstein Dr_Frankenstein

        Glad you sorted it, it’s good to have these little issues as you learn how to overcome them, thanks for sharing as I am sure it will help someone else!

    • Dr_Frankenstein Dr_Frankenstein

      It does look like you have setup everything correctly, when setting the folders within the CP interface can it see the directory correctly, as in if you were to create a folder in your /volume1/Downloads/Complete/Movies folder and then click in the interface can you see that folder?

      There was a mix up initially with the GUID, GPID etc as Linux|Server were using different Linux bases for some of the docker images, they are all the same now.

        • Dr_Frankenstein Dr_Frankenstein

          Looks like I mixed up, it’s definitely PGID and PUID, I am going to double check what screenshot I used in the other guides as I think I reused the old one.

  10. Wanderer Wanderer

    Thanks for the guide! Any chance of getting one for Sickrage?

  11. Espen Espen

    Hi there!
    lots of thanx your way for the effort! I do really appreciate it.
    I easily got all 3 up-and-running (SAB/CP/Sonarr), I am however unable to connect them..
    and I mean “connect them” as in They do not get access to SAB.
    The “host” seems to be incorrect. have been tried. SSL ON/OFF, HTTPS ON/OFF, triple checked setups, re-dwonloaded, refreshing API codes +++
    -no dice..
    I walked into the Docker world as ny Synology no longer wanted to start any of these programs, and the work-arounds on net seemed sketchy.
    But I´ve been at this for a 5-6 days now.. so any pointers would be great.

    • Dr_Frankenstein Dr_Frankenstein

      Did you get this fixed as I have never had any issues with the containers talking to each other. I use the IP and port number.

      • Espen Espen

        Thanx for the feedback..

        No I havent really..
        I just god some support from my brother as well (who´s had great success with your setups), and mine are exactly the same (part from the PUID..)
        But no dice..

        I am now in the prosess of backupíng the server, as it seems I have other system issues.. It might be Synology Related, and not Docker..

        I will rebuild my whole Raid Array, then I´ll try again..
        I´ll let you know how it went.. if you are intrested.
        will take some time though…

  12. Hondo Hondo

    Followed without any issues. Getting error in logs below when trying to get a movie. Using Synology Download station which connction was successful. Please help…

    ### Logs:
    06-23 17:51:06 ERROR [ couchpotato.core.event] Error in event “”, that wasn’t caught: Traceback (most recent call last):
    File “/app/couchpotato/couchpotato/core/”, line 15, in runHandler
    return handler(*args, **kwargs)
    File “/app/couchpotato/couchpotato/core/media/movie/providers/info/”, line 62, in getInfo
    cached = self.getCache(cache_key, self.urls[‘info’] % identifier, timeout = 3, headers = {‘User-Agent’: Env.getIdentifier()})
    TypeError: not enough arguments for format string
    encoding=UTF-8 debug=False args=[‘–config_file=/config/config.ini’, ‘–data_dir=/config/data’] app_dir=/app/couchpotato data_dir=/config/data desktop=None options=Namespace(config_file=’/config/config.ini’, console_log=False, daemon=False, data_dir=’/config/data’, debug=False, pid_file=’/config/data/’, quiet=False)
    06-23 17:51:07 INFO [hpotato.core.plugins.base] Opening url: get, data: []

  13. Hondo Hondo

    Resolved my issue. Had to setup the correct torrent service to download the movies. Disregard my previous post. Great instructions here. Worked perfectly other than my installation mistake.

    Now have Couch Potato, SickRage, and Crashplan all running via Docker containers on my DS712+. Much better managing resources than thru Synology’s package center. If you have an Intel Synology NAS, do yourself a favor and explore Docker containers…

  14. Dr., I am setting up a multimedia server on a Synology DS918+. I have read your guides on installing Docker, SABnzbd, Sonarr, and NZBHydra. Great stuff. I am looking for some help in configuring all these apps to download movies and put them into Plex where I can enjoy them at home. Can you offer some guidance and tell me how to repay you for your assistance. Thanks

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.

%d bloggers like this: