Skip to content

Sonarr, Radarr or Lidarr don't import finished downloads

TroubleshootingDeployrr v6.0+CurrentMediaApp networkingHost system

Your download client finishes a download, but Sonarr, Radarr or Lidarr never moves it into your library. You see one of these:

  • In Activity > Queue, the item stays there with a warning, or shows an import failed message.
  • In System > Status, a health warning says the download client places downloads in a folder that does not appear to exist inside the container. It points you to Remote Path Mappings.

The text differs a little between apps and versions. It looks like this:

Import failed, path does not exist or is not accessible by Sonarr

The download client and the Arr app each run in their own container. The Arr app asks the client where a finished file is. Then it looks for that file at the same path inside its own container. If it can’t see the path, or can’t read the file, the import fails.

In v6, these apps see the Downloads Folder from System > Folders at /data/downloads: Sonarr, Radarr, Lidarr, Mylar3, Prowlarr, Jackett, qBittorrent, qBittorrent VPN, SABnzbd, NZBGet, Plex, Jellyfin and Emby. Because the path is the same everywhere, most setups need no path mapping.

An import fails when one of these is true:

  • The client saves files somewhere outside /data/downloads.
  • You use Transmission, which sees only part of the folder at /data/downloads.
  • The Arr app is not connected to the client, or uses the wrong category.
  • The root folder in the Arr app is not under /data/media1, /data/media2 or /data/media3.
  • A file in the downloads folder belongs to another user.
  • The downloads folder is on a NAS and the mount is down.

Work through the checks in order. Stop when imports work.

  1. In Sonarr, Radarr or Lidarr, go to Activity > Queue.
  2. Hover over the warning icon on the stuck item, or open the item, to read the full message.
  3. Note the path it names.

If the path starts with /data/downloads, go to check 4 or check 6. If it starts with anything else, such as /downloads, go to check 2.

If you use Transmission, go to check 2 first, then check 3.

2. Keep the client’s folders under /data/downloads

Section titled “2. Keep the client’s folders under /data/downloads”

A path outside /data/downloads exists only inside the client’s container. The Arr app can’t see it. The files are also lost when that container is recreated.

qBittorrent and qBittorrent VPN

  1. Open the qBittorrent web UI.
  2. Go to Tools > Options > Downloads.
  3. Check that Default Save Path starts with /data/downloads. The settings Deployrr installs for qBittorrent use /data/downloads/torrents/others/. qBittorrent VPN starts with /downloads/, so change it to /data/downloads/torrents/others/.
  4. Check that the incomplete folder, if you use one, starts with /data/downloads. For example, /data/downloads/torrents/incomplete/.
  5. Check the save path of each category you use. Every one must start with /data/downloads.
  6. Select Save.

You can make a category per Arr app, such as tv-sonarr and radarr, with save paths under /data/downloads/torrents/. Deployrr creates movies, tv and others folders there for you, so /data/downloads/torrents/tv/ and /data/downloads/torrents/movies/ work well. Settings you change in the client apply at once. You don’t need to restart anything.

If you can’t open the web UI, see qBittorrent web UI says Unauthorized or won’t open.

To see why the default /downloads path is wrong, watch qBittorrent Docker Compose: set the download path to /data/downloads at 11:59 (manual Docker Compose setup).

SABnzbd

Deployrr does not set SABnzbd’s folders. Left at SABnzbd’s own defaults, downloads often go to a folder under /config, which only SABnzbd can see.

  1. Open the SABnzbd web UI and select the gear icon to open Config.
  2. Go to Folders.
  3. Set Temporary Download Folder to /data/downloads/usenet/incomplete.
  4. Set Completed Download Folder to /data/downloads/usenet/complete.
  5. Save the changes. If SABnzbd says a folder doesn’t exist, let it create the folder.
  6. Go to Config > Categories. Add a category for each Arr app, such as tv, movies and music. These are the names Sonarr, Radarr and Lidarr suggest for SABnzbd.
  7. Leave the folder of each category empty, or enter a plain name such as tv. A plain name is placed inside the Completed Download Folder. A full path that doesn’t start with /data/downloads breaks imports again.

NZBGet

Deployrr does not set NZBGet’s folders either.

  1. Open the NZBGet web UI and go to Settings > PATHS.
  2. Set MainDir to /data/downloads/usenet. DestDir and InterDir are built from it by default (${MainDir}/dst and ${MainDir}/inter), so they follow. If you changed them to a full path, make sure it starts with /data/downloads.
  3. Go to Settings > CATEGORIES. NZBGet comes with Movies, Series, Music and Software. Leave DestDir of each category empty, so NZBGet puts it in a folder named after the category inside DestDir.
  4. Save the settings at the bottom of the page. Reload NZBGet if it asks.
  5. Use the NZBGet category names in the Arr apps (check 4), spelled the same way: Series in Sonarr, Movies in Radarr and Music in Lidarr. Sonarr suggests tv, which doesn’t exist in NZBGet. Use Series, or add a tv category in NZBGet.

Transmission

Deployrr does not set Transmission’s download folder.

  1. Open Transmission’s settings and find the download folder.
  2. Set it to a path under /data/downloads, such as /data/downloads/others. Deployrr creates movies, tv and others folders that Transmission sees at /data/downloads.
  3. Save.

3. Add a remote path mapping for Transmission

Section titled “3. Add a remote path mapping for Transmission”

Transmission sees only the torrents folder inside your Downloads Folder, at /data/downloads. The Arr apps see the whole Downloads Folder at /data/downloads. So a file Transmission saves at /data/downloads/tv/x sits at /data/downloads/torrents/tv/x for the Arr app.

This mapping only works once Transmission saves under /data/downloads (check 2).

  1. In the Arr app, go to Settings > Download Clients.
  2. Scroll to Remote Path Mappings and add one.
  3. Set Host to the host name you used in the Transmission download client entry. With the default setup, that is transmission.
  4. Set Remote Path to /data/downloads/.
  5. Set Local Path to /data/downloads/torrents/.
  6. Save.

4. Check the download client entry in the Arr app

Section titled “4. Check the download client entry in the Arr app”
  1. In the Arr app, go to Settings > Download Clients.

  2. Open your client’s entry.

  3. Check that Host is the container name and the port is the internal port, as in the table.

    Client Host Port
    qBittorrent qbittorrent 8080
    SABnzbd sabnzbd 8080
    NZBGet nzbget 6789
    Transmission transmission 9091
    qBittorrent VPN gluetun 8080
  4. Check that the Category matches a category in the client, if the client uses categories. Case matters to some clients, so copy the name exactly.

  5. Enter the client’s login:

    • SABnzbd: paste its API key. You find it in SABnzbd’s Config pages, under General.
    • NZBGet: enter its username and password. Deployrr shows the defaults after install: nzbget and tegbzn6789.
    • Transmission: enter the username and password you chose when you installed it.
  6. Select Test. It should show a green check. If SABnzbd refuses the connection with a message about hostname verification, add sabnzbd to host_whitelist in SABnzbd’s Config > Special, save, and test again. Deployrr normally adds it for you during install.

  7. Save.

For the steps and the reasons behind these values, see Connect your apps to each other. For the VPN setup, see Install qBittorrent VPN.

To see the gluetun host and port 8080 entered in Radarr, watch Gluetun guide: add qBittorrent behind Gluetun as a download client in Radarr at 27:32 (manual Docker Compose setup). For background on why container names work as hosts, read UDMS part 14: Connecting the apps by container name (manual setup).

The Arr app moves the finished file into a root folder. That folder must be under /data/media1, /data/media2 or /data/media3.

  1. In Sonarr or Radarr, go to Settings > Media Management.
  2. Check that each root folder starts with /data/media1, /data/media2 or /data/media3.
  3. If you can’t pick a folder under /data, the app has no media folder. Go to Media app shows an empty library. It explains how to add a folder with a reinstall.

All these apps run as the same Linux user. A file created by root or another user can block the import.

  1. List the downloads folder with numeric owners. Replace YOUR_DOWNLOADS_FOLDER with the path next to Downloads Folder in System > Folders:

    Terminal window
    ls -ln YOUR_DOWNLOADS_FOLDER
  2. Compare the owner numbers with your own. To see your user and group numbers, run:

    Terminal window
    id
  3. If files or folders belong to another number, check the path again. Make sure it is your downloads folder and not / or your Docker folder.

  4. Make your user the owner of that folder and what it holds. Replace YOUR_USER with your Linux username and YOUR_DOWNLOADS_FOLDER with your path. The command assumes your main group has the same name as your user, which is the default on most systems:

    Terminal window
    sudo chown -R YOUR_USER:YOUR_USER YOUR_DOWNLOADS_FOLDER

For more on folder owners, see The app cannot read or write the folder.

If your downloads folder is on a NAS, the share may be down. The folder then looks empty, or is a plain local folder.

  1. List the folder on the server. Replace YOUR_DOWNLOADS_FOLDER with your path:

    Terminal window
    ls YOUR_DOWNLOADS_FOLDER
  2. If the list is empty and should not be, mount the share again. See Mount a NAS share with Rclone or Mount an SMB or NFS share without Rclone.

If you edit a compose file or .env file to change a path, recreate the app afterwards. See Stack Manager.

Downloads and media are separate folders inside each container. So the Arr apps can’t hardlink a finished file. They copy it into your media folder. The file then takes space twice while the torrent keeps seeding.

Hardlinks also need your downloads and media folders on the same drive or volume. If you download to a mini PC and keep media on a NAS, the files are always copied. See Hardlinks and Instant Moves in the TRaSH Guides.

Remove the torrent once it has seeded enough. Or open the download client entry in the Arr app and turn on Remove Completed, so the app removes the torrent after import.

  1. In the Arr app, go to Activity > Queue. Choose the stuck item and import it again if needed.
  2. The item leaves the queue.
  3. The file shows in your library under /data/media1, /data/media2 or /data/media3.
  4. In System > Status, the Remote Path Mappings warning is gone.