You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
TRaSH-Guides/docs/Sonarr/Sonarr-remote-path-mapping.md

87 lines
3.2 KiB

# 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.
- [Sonarr Wiki Servarr - Docker Guide](https://wiki.servarr.com/docker-guide#consistent-and-well-planned-paths){:target="_blank" rel="noopener noreferrer"}
- [TRaSH Guides](/Hardlinks/Hardlinks-and-Instant-Moves/){:target="_blank" rel="noopener noreferrer"}
------
## 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](images/dl_error.png)
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](images/cl_cli_tab.png)
At the bottom you choose `Add new mapping`
![!add new mapping](images/new_mapping.png)
A screen will pop up with the following options:
![add mapping](images/mapping.png)
1. `Host` => This is the hostname or IP you set in your download client settings.
1. `Remote Path` => The download path that you've set in your download client.
1. `Local Path` => The path Sonarr needs to access the same path.
------
??? example "Examples"
=== "QBittorrent"
## 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](images/qbit_client.png)
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](images/qbit_options.png)
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](images/qbit_final.png)
{! include-markdown "../../includes/support.md" !}
<!-- --8<-- "includes/support.md" -->