Skip to content

Remote Path Mappings

It seems that a lot of people don't understand how the remote path mapping works for Sonarr. I will try to explain it with some screenshots and a short description.

Remote Path Mapping acts as a dumb find Remote Path and replace with Local Path

When do I need remote path mappings

  • If Sonarr and your download client are not on the same server/system.
  • If you use either merged local/remote setups using mergerfs or similar.
  • You run dockers and DON'T have consistent and well planned paths.

Note

If you run dockers it would be smarter to fix the problem at the source what's causing the actual issue.

How do I recognize that I need remote path mappings

If your download client is on another system than Sonarr then you probably need to make use of Remote Path Mappings.

You will get an error that looks a little bit like the following screenshot.

!download errors

So looking at this screenshot it seems we need to make use of Remote Path Mappings

How

First we navigate in Sonarr to the Settings => Download Clients tab.

download client tab

At the bottom you choose Add new mapping

!add new mapping

A screen will pop up with the following options:

add mapping

  1. Host => This is the hostname or IP you set in your download client settings.
  2. Remote Path => The download path that you've set in your download client.
  3. Local Path => The path Sonarr needs to access the same path.
Examples

Host

To find what you need to put in your host you navigate in Sonarr to the Settings => Download Clients Tab. There you open up the download client for this example I will be using QBittorrent

Qbittorrent client

This is what you put in your Host in Remote Path Mapping.

Remote Path

To find what you need to put in your remote path you need to open up your download client and look what you've used there as download location.

In QBittorrent navigate to Tools => Options (or ALT+O) and navigate to the Download settings.

Qbittorrent download settings

This is what you add in your Remote Path in Remote Path Mapping.

Local Path

To find out what you need to put in in your local path you need to know how Sonarr is able to access the files that your download client downloaded. This can be done in different ways. Mounting/Network shares, whatever, but Sonarr needs to have local access to it, so you need to figure out the best way for Sonarr to access the download client's downloaded files yourself.

The final result will look something like this.

Qbittorrent final result

Questions or Suggestions?

If you have questions or suggestions click the chat badge to join the Discord Support Channel where you can ask your questions directly and get live support.

Discord chat