Skip to content

Unpackerr in Container Manager on a Synology NAS

Last updated on 28 January 2024

Important or Recent Updates
Historic UpdatesDate
Rewritten for Container Manager and config file updated08/07/2023
Changed the image to pull from docker hub as the old cr.hotio.dev is being phased out
Added additional security option to the compose to restrict the container from gaining new privileges
25/10/2023
Historic updates


What is Unpackerr

Unpackerr monitors your torrent client’s completed download folders and when a compressed file requires ‘Unpacking’ from a Zip or RAR it will do it automatically for you. It will then notify Radarr and other arrs the download is ready.

Let’s Begin

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

In order for you to successfully use this guide please complete these two additional guides

Folder Setup

Our next task is to set up a couple of folders for the config file and also the compose file

Open up File Station and go to the /docker share. Create a ‘projects’ then within this create a folder called ‘unpackerr-compose’. Then directly in the /docker share again create a ‘unpackerr’ folder

Config File Set up

In order to use Unpackerr we need to set up a number of variables in the config file, I have built a version with some pre-configured basics in line with the folder structure across the guides.

Download the pre-made config file below and save it into the newly created unpackerr folder.

Right Click and Save As: unpackerr.conf

Next up we are going to edit the file, so it can send notifications to the Arrs when it has completed its work.

Making your amendments

You can edit this file in a number of ways, but to keep the guide OS-agnostic we will be using the Synology Text Editor package which can be installed via Package Center.

Open up the config file in Text Editor you will see its nicely broken down into sections.

In the first section you can amend the preferences to your own liking I have set some sane defaults already.

In the second section you can start adding in your settings for the Arrs. Due to Radarr and Sonarr being the most commonly used applications I have left them in the file already. You will need to edit the following lines on each.

SettingsVariable to Use
url = “http://172.20.0.1:8989”This is the synobridge gateway IP you likely won’t need to change this, however you can also use your NAS IP.
api_key = “0123456789abcdef0123456789abcdef”Your API key can be located in the Arrs settings pages (Settings > General) copy and paste it between the “”
delete_orig = falseIf you want Unpackerr to delete the original compressed files when it has completed set this to ‘true’

If you are using other Arrs you can optionally copy the settings from below and add them into the config file and amend the same settings mentioned above accordingly

YAML
[[lidarr]]
  url = "http://172.20.0.1:8686"
  api_key = "0123456789abcdef0123456789abcdef"
  paths = ["/data/torrents/completed"]
  protocols = "torrent"
  timeout = "10s"
  delete_orig = false

YAML
[[readarr]]
  url = "http://172.20.0.1:8787"
  api_key = "0123456789abcdef0123456789abcdef"
  paths = ["/data/torrents/completed"]
  protocols = "torrent"
  timeout = "10s"
  delete_orig = false

We won’t be changing any of the settings in the final two sections of the config file for this guide. You can now save and exit the config file.

Container Setup

Next we are going to set up a ‘Project’ in Container Manager. Open up Container Manager and click on Project then on the right-hand side click ‘Create’.

In the next screen we will set up our General Settings.

Project Name’ will be ‘unpackerr’

Path’ click the button and select the folder we created earlier in ‘/docker/projects/unpackerr-compose’.

Source:’ change the drop-down to ‘Create docker-compose.yml’.

Next we are going to drop in our docker compose configuration, copy all the code in the box below and paste it into line ‘1’ just like the screenshot.

YAML
services:
  unpackerr:
    container_name: unpackerr
    image: ghcr.io/hotio/unpackerr
    environment:
      - PUID=1234 #CHANGE_TO_YOUR_UID
      - PGID=65432 #CHANGE_TO_YOUR_GID
      - TZ=Europe/London #CHANGE_TO_YOUR_TZ
      - UMASK=002
    volumes:
      - /volume1/docker/unpackerr:/config
      - /volume1/data:/data
    network_mode: synobridge
    security_opt:
      - no-new-privileges:true
    restart: unless-stopped
What on earth is a Docker Compose?
Docker Compose allows us to define how Docker should set up one or more containers within a single configuration file. This file is yaml formatted and generally saved as docker-compose.yml or compose.yml

Environment Variables

We are now going to amend some key variables to make sure the container has access to our folders and also knows where we are in the world. Don’t change any other settings other than those I mention.

PUID=⁣ – The UID you obtained in the user setup guide

PGID=⁣ – The GID you obtained in the user setup guide

TZ=⁣ – You will need to change this line to your own timezone code – you can find the correct list of ones to use on wikipedia.org/wiki/List_of_tz_database_time_zones

Once you have made the edits you can click ‘Next’

You do not need to enable anything on the ‘Web portal settings’ screen click ‘Next’ again.

On the final screen click ‘Done’ which will begin the download of the container images and once downloaded they will be launched!

Unpackerr will now be linked to Radarr/Sonarr etc and once a download has been completed that requires unpacking it will step in and do the work for you.




Buy Me a Coffee or a Beer

If you have found my site useful please consider pinging me a tip as it helps cover the cost of running things or just lets me get the odd beverage. Plus 10% goes to the devs of the apps I do guides for every year.

Published inDockerOther Tools 7.2Synology

7 Comments

  1. Gui Gui

    Hi dr! Just trying to go through your very useful tutorials and I came across an error trying to install unpackrr.
    cr.hotio.dev/hotio/unpackerr unavailable

    • Dr_Frankenstein Dr_Frankenstein

      Looks like they just stopped using the url swap to this

      ghcr.io/hotio/unpackerr

      Edit, this is weird as I fixed this months ago in October according to the updates table at the top of the post. Had a ton of people follow the guide since then..

  2. TokyoGringo TokyoGringo

    Another solid guide. Several questions:

    1. How does one test to confirm everything is working ok?

    2. How does one get unpackerr to run against already downloaded stuff, specifically in qbit’s completed directory if one followed your guide?

    3. Should one remove the ‘unrar x “%D/*.r*” “%D/”‘ config setting from qbit if one followed your guide?

    4. How to set it up to extract other stuff (a watch folder)?

    Thanks & Regards!

    • Dr_Frankenstein Dr_Frankenstein

      Hey without going into a ton of detail as there is some good documentation
      https://unpackerr.zip/docs/introduction

      1) You will need to find a torrent that requires unpacking – this is easier said than done I tend to find most sensible ones are just a single file never really understood the need to rar/zip movies.
      2) I don’t think you can as it monitors what Sonarr etc have told it to watch…
      3) Yes
      4) In the config file from the guide you can specify a monitored path for random stuff to extract

  3. Adam Adam

    Would this work if I wanted to capture usenet compressed files as well?


    [[lidarr]]
    url = “http://172.20.0.1:8686”
    api_key = “asdfasdfasdfasdfasdfasdfasddf”
    paths = [‘/data/torrents/completed’]
    protocols = “torrent”
    paths = [‘/data/usenet/completed’]
    protocols = “usenet”
    timeout = “10s”
    delete_orig = false

      • Adam Adam

        Thanks Dr, I didn’t realize they had unpacking built in. I had a few .rar’s that were supposedly done so I manually tried to extract them while I was waiting for your confirmation/correction of my thought process and they were corrupted anyway so that was probably what the issue was.

        Got everything set up though so I really appreciate your guidance!

Leave a Reply

Your email address will not be published. Required fields are marked *

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

drfrankenstein.co.uk – writing Synology Docker Guides since 2016 – Join My Discord!