Troubleshooting

Lidarr will not connect

Use the URL that Aurral can reach. Do not use the browser URL.
If both containers share a Docker network, the URL is often http://lidarr:8686.
Make sure that the Lidarr API key is correct.

Make sure that Aurral can connect to Lidarr.
Make sure that Lidarr contains artists.
Add a Last.fm API key for better discovery.
Set your listening-history provider in Profile (Last.fm or ListenBrainz username, or Koito instance URL).
Run a manual refresh from Settings > Discover.

Configure one or more download sources. Use Settings > Download Clients or Settings > Indexers.
For yt-dlp, select Test connection.
Make sure that the host has yt-dlp and ffmpeg. The Docker image includes both programs.
For slskd, check the connection and the Soulseek login status.
For Usenet, enable the Prowlarr indexers.
Make sure that the Usenet client can reach completed files.
If FLAC matches are scarce, disable Strict format only on the slskd card.
You can also set the preferred format to MP3.
Check job states on the Playlists page and History.

Make sure that Aurral mounts the same media root as Lidarr (Match Lidarr).
Make sure that Settings > Download Clients > Downloads Folder > Path is under that mount.
Make sure that Navidrome scans Aurral’s downloads path and not only Lidarr’s library.
Review the Navidrome missing-track setting.

Symptoms can include the message Lidarr track exists but file is not accessible from Aurral.

Completed slskd or Usenet files can also remain in their source folders. Test library access can fail while Lidarr is operational.

Mount the same parent host folder that Lidarr uses into Aurral.
Do not use separate mounts for the library and downloads.
For example, use N:/ServerFolders/Music:/music.
Set Downloads Folder > Path under that mount, for example, /music/Aurral.
After you change Compose volumes or environment, recreate the container: docker compose up -d --force-recreate.
Run Settings > Lidarr > Test library access to see the exact path Aurral cannot read.
If necessary, set PATH_MAPPINGS=N:/ServerFolders/Music|/music in the Compose file.
You can also add mappings under Settings > Download Clients > Remote Path Mappings.
For NZBGet on Windows, open Settings > Download Clients > NZBGet.
Set Completed download path if Aurral cannot detect the folder automatically.

Flows or shared playlists can appear in Navidrome, but the tracks do not play.

The path problem is common when Aurral runs in Docker and Navidrome runs on Windows.

Make sure that Test library access passes in Lidarr settings.
Enable Use Navidrome paths in M3U files and add a Navidrome path mapping in Settings > Playback > Navidrome.
Alternatively, set M3U_PATH_MODE=remote and M3U_PATH_MAPPINGS in the Compose file.
Recreate the container.
Refresh the playlists to rewrite the .m3u files.
Run or save a flow. You can also edit and save a shared playlist.
Open a generated .m3u under aurral-weekly-flow. Make sure that track lines use paths Navidrome can open.

Leave Use Navidrome paths in M3U files off when Navidrome runs in Docker with the same mounts as Aurral.

Sync to Plex now can succeed while the playlists have no tracks. The Aurral library can also stay empty after a scan.

Make sure that Plex can read the flow download tree.
The Plex container or host must contain this path: <downloads>/aurral-weekly-flow/<flow-id>/....
If Plex and Aurral use different mounts, set Plex downloads path to the folder that Plex sees.
Leave Plex downloads path blank if both apps use the same path prefix.
Save the settings.
Select Sync to Plex now again.
Initial scans can take several minutes. Aurral runs catch-up synchronization in the background while Plex indexes files.
Make sure that flows finish their downloads before you expect Plex playlists to populate.
Use Navidrome paths in M3U files does not apply to Plex.

Make sure that AUTH_PROXY_TRUSTED_IPS matches the source address of your reverse proxy.
This value is different from TRUST_PROXY. Use the proxy access logs to find its source address.
If you enable proxy authentication, set AUTH_PROXY_TRUSTED_IPS before you expose the app.
For Authelia or forwardAuth, set AUTH_PROXY_DOMAIN to your authentication origin.
Without this value, the browser can block the login redirect and reauthentication.
For Authentik, curl -i https://your-aurral-host/outpost.goauthentik.io/ping must return 204.
If it returns Aurral HTML, route /outpost.goauthentik.io directly to the Authentik outpost.
Use the same correction if it returns another authentication redirect.
Do not apply auth_request to that route.
If Authentik logout returns to Aurral’s login page, check the logout variable.
Use the exact variable name AUTH_PROXY_LOGOUT_URL.
Set its value to https://your-aurral-host/outpost.goauthentik.io/sign_out.
This problem affects only proxy-auth setups that use AUTH_PROXY_ENABLED or AUTH_PROXY_HEADER. It does not affect local password login.
The reload must stop automatically after a few attempts. Check the browser console for a message that gives the cause.

Official images preload jemalloc. This lets sharp return free native memory after it optimizes cover art.

Aurral fetches covers on demand without a background prefetch. It caches each cover as a card-size WebP image (512px).

The image-proxy disk cache has a 256MB limit and uses least-recently-used removal. Restart Aurral if you need a clean memory baseline.

Make sure mounted folders are writable by the container user.
Set PUID and PGID to match your host folder owner. Follow Servarr’s Docker Guide for shared-group setups.