Sonarr, Radarr or Lidarr don't import finished downloads
Symptoms
Section titled “Symptoms”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 SonarrThe 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/media2or/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. Read the path in the message
Section titled “1. Read the path in the message”- In Sonarr, Radarr or Lidarr, go to Activity > Queue.
- Hover over the warning icon on the stuck item, or open the item, to read the full message.
- 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
- Open the qBittorrent web UI.
- Go to Tools > Options > Downloads.
- 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/. - Check that the incomplete folder, if you use one, starts with
/data/downloads. For example,/data/downloads/torrents/incomplete/. - Check the save path of each category you use. Every one must start with
/data/downloads. - 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.
- Open the SABnzbd web UI and select the gear icon to open Config.
- Go to Folders.
- Set Temporary Download Folder to
/data/downloads/usenet/incomplete. - Set Completed Download Folder to
/data/downloads/usenet/complete. - Save the changes. If SABnzbd says a folder doesn’t exist, let it create the folder.
- Go to Config > Categories. Add a category for each Arr app, such as
tv,moviesandmusic. These are the names Sonarr, Radarr and Lidarr suggest for SABnzbd. - 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/downloadsbreaks imports again.
NZBGet
Deployrr does not set NZBGet’s folders either.
- Open the NZBGet web UI and go to Settings > PATHS.
- Set MainDir to
/data/downloads/usenet. DestDir and InterDir are built from it by default (${MainDir}/dstand${MainDir}/inter), so they follow. If you changed them to a full path, make sure it starts with/data/downloads. - Go to Settings > CATEGORIES. NZBGet comes with
Movies,Series,MusicandSoftware. Leave DestDir of each category empty, so NZBGet puts it in a folder named after the category inside DestDir. - Save the settings at the bottom of the page. Reload NZBGet if it asks.
- Use the NZBGet category names in the Arr apps (check 4), spelled the same way:
Seriesin Sonarr,Moviesin Radarr andMusicin Lidarr. Sonarr suggeststv, which doesn’t exist in NZBGet. UseSeries, or add atvcategory in NZBGet.
Transmission
Deployrr does not set Transmission’s download folder.
- Open Transmission’s settings and find the download folder.
- Set it to a path under
/data/downloads, such as/data/downloads/others. Deployrr createsmovies,tvandothersfolders that Transmission sees at/data/downloads. - 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).
- In the Arr app, go to Settings > Download Clients.
- Scroll to Remote Path Mappings and add one.
- Set Host to the host name you used in the Transmission download client entry. With the default setup, that is
transmission. - Set Remote Path to
/data/downloads/. - Set Local Path to
/data/downloads/torrents/. - Save.
4. Check the download client entry in the Arr app
Section titled “4. Check the download client entry in the Arr app”-
In the Arr app, go to Settings > Download Clients.
-
Open your client’s entry.
-
Check that Host is the container name and the port is the internal port, as in the table.
Client Host Port qBittorrent qbittorrent8080SABnzbd sabnzbd8080NZBGet nzbget6789Transmission transmission9091qBittorrent VPN gluetun8080 -
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.
-
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:
nzbgetandtegbzn6789. - Transmission: enter the username and password you chose when you installed it.
-
Select Test. It should show a green check. If SABnzbd refuses the connection with a message about hostname verification, add
sabnzbdto host_whitelist in SABnzbd’s Config > Special, save, and test again. Deployrr normally adds it for you during install. -
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).
5. Check the root folder
Section titled “5. Check the root folder”The Arr app moves the finished file into a root folder. That folder must be under /data/media1, /data/media2 or /data/media3.
- In Sonarr or Radarr, go to Settings > Media Management.
- Check that each root folder starts with
/data/media1,/data/media2or/data/media3. - 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.
6. Check who owns the files
Section titled “6. Check who owns the files”All these apps run as the same Linux user. A file created by root or another user can block the import.
-
List the downloads folder with numeric owners. Replace
YOUR_DOWNLOADS_FOLDERwith the path next to Downloads Folder in System > Folders:Terminal window ls -ln YOUR_DOWNLOADS_FOLDER -
Compare the owner numbers with your own. To see your user and group numbers, run:
Terminal window id -
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. -
Make your user the owner of that folder and what it holds. Replace
YOUR_USERwith your Linux username andYOUR_DOWNLOADS_FOLDERwith 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.
7. Check the mount
Section titled “7. Check the mount”If your downloads folder is on a NAS, the share may be down. The folder then looks empty, or is a plain local folder.
-
List the folder on the server. Replace
YOUR_DOWNLOADS_FOLDERwith your path:Terminal window ls YOUR_DOWNLOADS_FOLDER -
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 use double the space
Section titled “Downloads use double the space”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.
Check it worked
Section titled “Check it worked”- In the Arr app, go to Activity > Queue. Choose the stuck item and import it again if needed.
- The item leaves the queue.
- The file shows in your library under
/data/media1,/data/media2or/data/media3. - In System > Status, the Remote Path Mappings warning is gone.

