Match Lidarr

Aurral is a Lidarr companion. Aurral uses the Lidarr storage layout.

If your player sees the Lidarr library, mount the same media root into Aurral.

The rule

Mount the same media volume Lidarr uses, at the same container path. Most stacks use /data:/data.

volumes:
  - /data:/data
  - ./config:/config

/config is Aurral-only (database, settings, secrets). Do not share it with Lidarr.

For path design, hardlinks, and permissions, use the Servarr guides:

• Servarr Docker Guide: one common volume, consistent paths
• Lidarr Docker notes: same /data advice for Lidarr images

After the mount

1. Open Settings > Download Clients > Downloads Folder > Path.
2. Set a folder under the media root.
3. Connect Lidarr.
4. Run Test library access.
5. If you use Navidrome, add the Aurral downloads path as a music folder.
6. If you use Plex, let Aurral register the downloads path.

For example, set the downloads path to /data/downloads/aurral.

A scan of only the Lidarr library does not include Aurral output.

yt-dlp writes directly into that downloads path. If Lidarr shares /data with slskd or Usenet, Aurral can see the completed folders.

Example layout

This example uses the standard Servarr layout. You can use a different layout if all containers see the same paths.

/data/
|-- music/                 # Lidarr root folder
\-- downloads/
    |-- slskd/complete/    # slskd finished downloads (if used)
    |-- nzbget/completed/  # optional Usenet completed
    \-- aurral/            # Aurral Downloads Folder path
        \-- aurral-weekly-flow/

Service	Mount	Notes
Lidarr	/data:/data	Root folder, for example, /data/music
Aurral	/data:/data	Same mount. Set Downloads Folder in the UI.
slskd	/data:/data	Same mount that Lidarr uses
SABnzbd/NZBGet	/data:/data	Same mount that Lidarr uses
Navidrome	/data:/data:ro	Scan Lidarr library and Aurral’s downloads path
Plex	/data:/data	Reads Aurral’s aurral-weekly-flow tree

App state stays in ./config:/config and is not shared.

Windows and mixed Docker setups

If Lidarr runs on Windows, it can report a path such as N:\Music\.... Aurral cannot read this path in Docker.

Mount the Windows folder into Aurral:

services:
  aurral:
    volumes:
      - N:/ServerFolders/Music:/music
      - ./config:/config

Example mapping: map the remote path N:/ServerFolders/Music to the local path /music.

Add this mapping under Settings > Download Clients > Remote Path Mappings.

You can also set PATH_MAPPINGS=N:/ServerFolders/Music|/music in the Compose file. Aurral applies the value at runtime.

You can edit the mapping in the UI after Aurral starts.

Then run Settings > Lidarr > Test library access.

Note

Compose PATH_MAPPINGS do not appear as environment fields in the UI. Use Settings > Download Clients > Remote Path Mappings to view or edit them.

When the player sees different paths

If Navidrome uses different paths, enable Use Navidrome paths in M3U files under Settings > Playback > Navidrome.

If Plex uses different paths, set Plex downloads path under Settings > Playback > Plex.

See Navidrome and Plex.

Next: First run