How to Set Up Unpackerr with Docker Compose (Step-by-Step Video)

Unpackerr logo with the words install with Docker Compose, unpack RAR downloads

For educational purposes only. This guide shows how to install self-hosted software on your own hardware. I don't condone piracy: only use these apps with media you own or have the right to use, and follow the law where you live. Back up your data first. Full disclaimer

Updated 16 November 2026 Tested with: Unpackerr 1.0.1

A lot of torrents arrive as a set of RAR files instead of a video. Radarr and Sonarr can’t import those, so the download sits in the queue for ever. Unpackerr fixes that. It spots the waiting download, unpacks it and lets your app carry on, and the torrent keeps seeding.

This guide sets up Unpackerr with Docker Compose in five short steps. It takes about 10 minutes.

Radarr queue showing Downloaded - Waiting to Import and the message Found archive file, might need to be extracted

If Radarr or Sonarr shows Found archive file, might need to be extracted, as above, Unpackerr is what you’re missing.

On this page (12 sections)

Watch: install Unpackerr with Docker Compose

The video has subtitles at the bottom and no sound. It was recorded on a clean test install of Unpackerr 1.0.1 connected to a test Radarr. Version 1.0 checks your apps quietly, so the web page on port 5656 is the easiest way to see it working.

See what Unpackerr does

Press Next to follow a pretend film from qBittorrent to your library. Then stop Unpackerr, break the path or switch to a plain video file, and press Start again to see what changes. Under the demo is the generator that writes your files.


Open the generator full screen

What you need to set up Unpackerr with Docker Compose

Use Usenet only? You probably don’t need this. SABnzbd and NZBGet normally unpack downloads themselves. Unpackerr is mostly for torrents.

Step 1: Make your compose file

In the generator, pick your apps and fill in your server details. Save compose.yaml and .env in a new folder. For Radarr and Sonarr with torrents, the compose file looks like this:

services:
  unpackerr:
    image: golift/unpackerr:latest
    container_name: unpackerr
    user: ${PUID}:${PGID}
    environment:
      - TZ=${TZ}
      - UN_WEBSERVER_UI_PASSWORD=admin:${UI_PASSWORD}
      # Radarr
      - UN_RADARR_0_URL=http://192.168.1.10:7878
      - UN_RADARR_0_API_KEY=${RADARR_API_KEY}
      - UN_RADARR_0_PATHS_0=/data/downloads
      - UN_RADARR_0_PROTOCOLS=torrent,TorrentDownloadProtocol
      # Sonarr
      - UN_SONARR_0_URL=http://192.168.1.10:8989
      - UN_SONARR_0_API_KEY=${SONARR_API_KEY}
      - UN_SONARR_0_PATHS_0=/data/downloads
      - UN_SONARR_0_PROTOCOLS=torrent,TorrentDownloadProtocol
    volumes:
      - ${CONFIG_ROOT}/unpackerr:/config
      - ${DATA_ROOT}:/data
    ports:
      - 5656:5656
    restart: unless-stopped

The one thing to get right is the /data line. Unpackerr has to see each download at the same path your app does. If Radarr calls a download /data/downloads/Film, it must be at /data/downloads/Film inside Unpackerr too. If your apps use something else, such as /media, change Data path in your apps in the generator.

Step 2: Add your password and API keys

Open .env and choose a password for UI_PASSWORD. Don’t leave it empty.

Then, for each app, go to Settings → General → API Key, copy the key and paste it into the matching line.

Step 3: Start Unpackerr

The generator’s Commands tab has these with your own folders filled in:

sudo mkdir -p /opt/arr/config/unpackerr
sudo chown -R 1000:1000 /opt/arr/config/unpackerr
docker compose up -d

Step 4: Check it can see your apps

Open http://your-server-ip:5656 and log in as admin with your UI_PASSWORD. Each app should be listed under Starr queues, with a recent time next to it.

Unpackerr Overview page with counters for extracted and deleted downloads, Radarr under Starr queues, and Activity and History lists

You can also check the log:

docker logs unpackerr --tail 20

A healthy app logs a line like [Radarr] Updated: 0 Items Queued, 0 Retrieved.

Settings from your compose file are locked on the web page. That’s normal. To change them, edit compose.yaml or .env and run docker compose up -d again.

Step 5: Watch your first RAR

There’s nothing else to do. The next time a RAR download finishes, this is what happens with the default settings:

  1. Within a few minutes, Unpackerr unpacks the video next to the RAR files. It checks your apps every 2 minutes.
  2. On Radarr’s next look, the film is imported into your library. In a test it took about a minute.
  3. 5 minutes after that, Unpackerr deletes its spare unpacked copy. The RAR files stay, so the torrent keeps seeding, and the film stays in your library.
[Radarr] Extraction Queued: /data/downloads/Sintel.2010.1080p.BluRay.x264-RARTEST
Extraction Started: Sintel.2010.1080p.BluRay.x264-RARTEST, items in queue: 0
Extraction Finished: Sintel.2010.1080p.BluRay.x264-RARTEST => elapsed: 0s, archives: 3, files extracted: 1
[Radarr] Imported: Sintel.2010.1080p.BluRay.x264-RARTEST (delete in 5m0s)
Deleted (recursively): /data/downloads/Sintel.2010.1080p.BluRay.x264-RARTEST/Sintel.2010.1080p.BluRay.x264-RARTEST.mkv

A plain video file doesn’t need any of this. Radarr imports it as usual, and Unpackerr logs not extracted, removing from history.

Using Cleanuparr? Its official blocklist removes torrents packed in RAR files, so Unpackerr never gets to see them. My Cleanuparr guide shows the short blocklist that keeps them.

Don’t turn on DELETE_ORIG for torrents

The DELETE_ORIG setting deletes the whole download folder after import, RAR files included, so a torrent has nothing left to seed. Unpackerr’s own notes advise against it for torrents, and I didn’t need it. It’s off by default, so just leave it out.

If it doesn’t work

What you see What to do
no extractable files found at: /data/downloads/… with stat err Unpackerr can’t see the path your app reports. Make the /data volume match your app’s.
API Key is too short (… < 32), skipped and ignored The key in .env is still the placeholder, or got cut off. Paste it again.
invalid status code, 401 The key is the wrong one for that app. Copy it again from Settings → General.
Updated: 1 Items Queued but nothing is ever extracted Check PROTOCOLS. A wrong value fails silently. Use what the generator gives you.
no extractable files found with no stat err Unpackerr can see the files, and none is a RAR. The app is waiting for another reason, so look at the message in its queue.
Forgot the web password Change UI_PASSWORD in .env and run docker compose up -d.

Updating Unpackerr

cd ~/unpackerr
docker compose pull && docker compose up -d
Coming from version 0.x? Version 1 adds the web page on port 5656, which is on by default. Add the /config volume and UI_PASSWORD from Step 1 before you update. If you use folder watching or metrics, read the official upgrade guide first, because those changed.

I tested this guide on version 1.0.1 with Radarr and qBittorrent, using a real multi-part RAR. Menus may move a little in later versions.

Frequently asked questions

What does "Found archive file, might need to be extracted" mean?

The download arrived as RAR files, which Radarr and Sonarr can't import. Unpackerr spots it, unpacks it, and lets your app carry on.

Does Unpackerr stop my torrent seeding?

No. It extracts a copy and leaves the RAR files in place, so the torrent keeps seeding. Don't turn on DELETE_ORIG for torrents.

What does "API Key is too short" mean?

The key in .env is still the placeholder or got cut off. Copy it again from the app's Settings → General.

Why does Unpackerr say "no extractable files found"?

With a stat error, it can't see the path your app reports, so make the /data volume match your app's. Without one, there's no RAR in that download and the app is waiting for another reason.

Thank you

Unpackerr is free and open source, made by David Newhall and the Unpackerr team.

Related guides: Media Server Stack · Radarr · Sonarr · qBittorrent · Cleanuparr

If this guide helped you, consider buying me a coffee. It helps keep guides like this one coming.

☕Buy me a coffee

Get new guides by email

About one email a month: new step-by-step guides and card releases. No spam, unsubscribe any time.

I'll send a confirmation email first. See the privacy policy.

Leave a Reply