Skip to content

Setting up Radarr in Docker on a Synology NAS

Last updated on 24th June 2017

In this guide I will take you through the steps to get Radarr up and running in Docker. As more people move away from using Couchpotato I thought it was time to get this guide up, the setup itself is very similar to Sonarr.

Downloading the Container

Open up Docker within DSM and navigate to the ‘Registry’ tab and search for ‘Radarr’ in the list of available containers select the one made by Linux|Server as shown below, right click on it and select ‘Download’ or click the button at the top of the window.

Download Radarr from Linux|Server

You can check the status of the download over on the ‘Image’ tab, while we wait for the download to complete lets move onto the next step.


In order for the Docker container to access the shares on the NAS we need to give it the same permissions as a user who has access to those shares, we achieve this by associating the correct Personal User ID and Personal Group ID to the container.

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.

SSH into your Synology to find out your ID’s

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 your 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. Make note of these values as we will need them later.

Command to get the ID’s

Setting up the container

Now we have downloaded the container and got hold of our user IDs we can move onto the next stage, where we will configure the Docker container. First go back into Docker and click on the ‘Image’ tab, in the list of your containers select the ‘Linux|Server Radarr’ image and click on ‘Launch’

You will now see the initial setup screen, if you want to you can change the name of the container to something else, or if you are using a number of services on a machine with a limited amount of memory or lower powered CPU you can also setup resource limitations, this is generally not required.

The initial setup screen

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 and setup with the correct settings. On the first tab you can decide to put an icon on your desktop, you will need to specify the IP address and port so you may want to come back to this once we have decided on the port number later in the guide. The other option is to enable ‘Auto Restart’ I would suggest turning this on as this will ensure Radarr will automatically start up whenever you reboot your NAS.

Going advanced


We can now move onto the volume tab in which we will be specifying the directories where Radarr will be able find our existing movies, the location where your movies are downloaded to and a folder to store its configuration files. As you can see in the screenshot you will need to browse to each of the directories and add a corresponding mount point inside the Docker container. I generally keep all of my configuration settings in my Docker directory so they can easily be backed up. The other folders you will need to amend based on your own folder locations.

Add your existing movie and download locations


You do not need to setup anything on this page.

Port Settings

We will now configure our port settings, in some of my earlier guides I used to change the external port to something random to make it harder to find, as I had all my ports forwarded for external access, I now use the Synology VPN so you can generally manually specify the same port numbers as the container. Do not leave the port to AUTO as it can potentially change with every restart of the container and you will have to go fishing for it each time.

Setup your port


You do not need to setup anything on this page.

Environment Variables (PGID,  PUID and Timezone)

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 added. As well as this a new requirement is that we add the correct Timezone to the container you can do this as shown in the screen shot below, you can find a list of timezone here


Adding the enviroment variables

Almost Done

You have now completed the setup of the container, click on OK to move back to the initial settings screen and then click next, you will be shown an overall summary of the settings we have specified, this is a good time to double check everything is correct. Finally click on Finish and the container should start to boot.

Final Summary

You should now be able to access Radarr via the IP of your NAS followed by the port number you specified.

Now if you are looking for some help setting up Sonarr itself head over to our configuration guide

Published inDockerSynology


  1. one4nine one4nine

    First off – thanks for taking the time to post this – your guides have been helpful!

    I have added both Sonarr and now Radarr to my Synology via Docker and, for the most part, they seem to be operating well.

    The only issue I am having is in the final step. Movies (or episodes) get picked up and sent to SabNZBD, download, then get moved from the download folder to the (Plex) library folder. At this point what should happen (and used to in Sonarr’s case when I had it running outside of Docker), is the file gets renamed according to specification (and placed into Show/Season folders if TV).

    Instead, movies are just sitting in a folder with the same name as the download file. Curiously, Radarr DOES create the correctly renamed movie folder, it just doesn’t complete the final step of moving the file into it (so there will be an empty folder “Title (Year)” and a populated folder “TitleDownlaodfileName.Filecontainer.etc” that contains the movie file. Sonarr’s case is similar; file is moved to the library folder but remans in a folder in the library’s root (vs the show’s sub folder).

    TLDR, I think I may have a rights issue stopping some part of the renaming process, but not sure how to remedy. Any pointers? Thanks again!

    • Zail Zail

      Have you figured this out? I have the exact same issue and don’t know how to fix it.

  2. Jared Maxwell Jared Maxwell

    Anyone having the missing mount /etc/localtime error? I’m unable to add that mount point and just stuck. Happens with both Radarr and Sonarr. Anyone know of a solution?

    • Mitchell Mitchell

      Yes! I had been been getting it too. It seems like with Sonarr and Radarr you now have to also set the TZ environment variable to get it to work.

    • Dr_Frankenstein Dr_Frankenstein

      Thanks, both Sonarr and Radarr guides have been updated with the information needed to get around this issue, you just need to specify a Timezone.

  3. Kevin Kevin

    Your guides have been a tremendous help getting things running on my NAS. There is one thing left that still eludes me:

    How to update the docker images. Some guides tell you not to use the update functions for Sonarr and Radarr in the images, but rather should update the container image itself whenever an update is needed.

    How is this done while preserving everything? I’ll admit to being clueless. 🙂

  4. Kevin Kevin

    I wanted to follow up on my comment to say I found a method that is fairly simple and works. I found instructions on the Home Assistant software page that worked with one change.

    1) Login to Synology. Open Docker.
    2) Go to the registry and download the latest version of the container.
    3) Go to Container. Stop the container.
    4) Right click the container and select Action > Clear.
    5) Start the container again. It will start with new image with the config intact.

    This worked with both Sonarr and Radarr.

    • Dr_Frankenstein Dr_Frankenstein

      Thanks Kevin, I think I will put together a separate guide for updating, as it will be a royal pain updating all my guides, at least then if the method changes I can do quick updates.

    • Mathias Mathias

      When I do this the config for Radarr is lost, but the config for the container is intact. However it only takes a few commands to restore the config backup so no biggie. However I am curious on why the config is maintained for you, cause “clear” means clear all container data…

  5. George George

    I must of done something wrong, but I keep getting this error:
    Import failed, path does not exist or is not accessible by Radarr:

    • Dr_Frankenstein Dr_Frankenstein

      Did you get this fixed? Likely a permissions issue to the directory or it’s mapped incorrectly

    • Defeated Defeated

      I am also getting this error. Apparently one of the fixes is to make sure the SAB and Radarr download directories appear exactly the same in “Volumes”.

      However my SAB is /mnt/downloads
      and Radarr is /downloads

      If I try to change Sab I get an error that it can’t create the /downloads/complete folder

    • Tim Tim

      Set the remote path in Radarr or Sonarr correctly. It’s under download client tab at the bottom. Visible by toggling show advanced.

      Also use the UID and GID under Media Management in Sonarr and Radarr.

      • Nick Nick

        Can you please give me a screenshot of how this should look? For the life of me i cant figure out how this works.

        And also when i set the UID/GID, i get the error that they can’t change the permissions.


  6. Defeated Defeated

    I am a little confused. On your Sab guide the folder is downloads, on this one is download

    Should they match in the config of both Radarr and Sab?

    • Dr_Frankenstein Dr_Frankenstein

      It’s probably because I had to recreate my download share between writing those guides. Just use whatever you called yours.

  7. N1nj4 N1nj4

    Has anyone had any success in setting up radarr to use SSL connections?

  8. Dustin Dustin

    I would love to see a write up on Headphones, Jacket, and a home automation system such as Eynio

    • Dr_Frankenstein Dr_Frankenstein

      Jackett is certainly possible as I am using it, I gave up with Headphones a long time ago and eagerly awaiting Lidarr

      • Dustin Dustin

        Yeah Headphones is garbage. I tried to setup Radarr but it does not pull large IMDB lists like CouchPotato does, so I am back using CP now. If Radarr supported large lists I would definitely use it instead.

  9. David David

    Hi All,
    I have followed these instruction to the letter, but when I go to the IP of NAS with port number, cannot connect “This site can’t be reached”. Any ideas please?

  10. Thomas Jespersen Thomas Jespersen

    It worked perfectly fine except I had to enable Terminal Services in the control panel of my synology as first step.

  11. Trevor Trevor

    Why are your File/Folder and Mount Path on this guide “download” and on the nzbget and Sonarr guide the plural “downloads”? If you are installing all three (and I suspect most would) should it not be consistent across all three packages? I have been fighting this install in Docker on a Synology DS and want to make sure I have this right.

    • nvm nvm

      NVM – I see this was previously asked and answered. Sounds like it should be consistent across all three packages

  12. iKomrad iKomrad

    How does volume mapping work with multiple download locations?
    for example:
    Download client – Download location .
    ngbget /nbzbget/completed/movies
    transmission . /transmission/completed/movies

    How do I configure it so that Radarr knows about these 2 locations to pull file form?
    I’m guessing it involves the downloads folder.
    Would I map downs to both? like
    -v /nbzbget/completed/movies:/downloads/nzbget
    -v /transmission/completed/movies:/downloads/transmission

    Would that work?

    • Dr_Frankenstein Dr_Frankenstein

      Could you not have both your torrent client and NZBGet download to the same location and then use categories to ensure Movies go into one folder TV in another etc.

  13. Jim Jim

    I used your tutorial to get me all setup awhile back. All the sudden it’s not working with plenty of errors in the log. I’m running it in docker of course but I’m thinking I’ll need to start from scratch. Is there a way to install again and use one of the backups so I don’t lose everything and to where it’s as painless as possible?

    • Dr_Frankenstein Dr_Frankenstein

      You can export the config only within the Docker interface delete the container and its original image, redownload the image fresh and import the Docker config file. You should be set.. About 5 minutes work

      • Jim Jim

        Thanks. Didn’t fix the problem unfortunately. Any idea why I suddenly can no longer search for anything. It just pops up saying there was an error searching. It’s happened in the past but it’s been a month now and still not working. “Request failed: error resolutions failure” I believe is the error in the log. Any clue what the deal could be?

        • Dr_Frankenstein Dr_Frankenstein

          Are you searching your indexers directly or via Hydra(2)

          • Jim Jim

            Just directly with the search on Radarr. Never used hydra

  14. Jim Jim

    Any suggestions?

    • Dr_Frankenstein Dr_Frankenstein

      Google didn’t really come up with much, it’s not something simple like the API key being incorrect

  15. JIm JIm

    how frustrating

Leave a Reply

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

%d bloggers like this: