Storage and backups

Aurral keeps app state and generated music separate.

For mounts, follow Match Lidarr. Use the Lidarr media root and set the downloads path in the UI.

Storage locations

Path	Contains
/config	Database, settings, users, sessions, cache state, playlist jobs, and the default yt-dlp staging directory. Mount it with ./config:/config. Do not share it with other apps.
/data (or Lidarr’s media root)	Shared library and downloads. Same mount Lidarr uses.
Downloads Folder	Generated flows, imported playlists, and playlist files. Set in Settings > Download Clients > Downloads Folder > Path (for example /data/downloads/aurral).

Note

/config replaces the older /app/backend/data path from Aurral v1. At startup, Aurral automatically detects existing databases in either location.

Back up your data

• Back up the mounted /config folder.
• Back up the Downloads Folder if you want to keep generated playlists after a rebuild.
• Back up the Compose file and .env file.

yt-dlp stages downloads in /config/_staging by default. You can mount another persistent path and select it under Settings > Download Clients > yt-dlp > Staging path. Keep it outside media-server libraries to avoid scanner activity while files are incomplete.

Library safety

• Aurral does not write into your root music library.
• Artist and album changes go through Lidarr.
• Flows and imported playlists stay under Aurral’s Downloads Folder path.