Storage and backups
Aurral keeps its own data separate from your music. It also needs the same view of the media files as your download clients, your playback server, and Lidarr if you use it.
For the full mount setup, follow Filesystem and mounts. In short, mount your media root, and set the Downloads Folder to a path inside Aurral, such as /data/downloads/aurral. If you use Lidarr, mount the Lidarr media root at the same path that Lidarr uses.
Storage locations
Section titled “Storage locations”| Path | Contents |
|---|---|
/config |
The database, settings, users, sessions, caches, playlist jobs, and the default yt-dlp staging folder. Mount it with ./config:/config. Do not share it with other applications. |
/data |
The shared media root. Mount the same host folder here in Aurral, Lidarr, your download clients, and your playback servers. |
| Downloads Folder | Aurral’s permanent tracks, temporary flow tracks, and playlist artwork. Set it in Settings > Download clients > Downloads Folder > Path, for example /data/downloads/aurral. |
yt-dlp writes downloads to /config/_staging first. To use another disk, mount it and select it in Settings > Download clients > yt-dlp > Staging path. Keep this folder outside every media server library, so that servers do not scan unfinished files.
Back up your data
Section titled “Back up your data”- Back up the
/configfolder. - Back up the Downloads Folder. Without Lidarr, it holds all of your music.
- Back up the Compose file and the environment file with your host paths.
Library safety
Section titled “Library safety”- Lidarr is optional. Aurral and Lidarr each keep their own folders. While Lidarr is connected, the Library shows both without moving files. Turning Lidarr off removes its music from the Library and leaves the files on disk.
- Aurral never writes to or deletes files in a Lidarr root folder. Changes to Lidarr artists and albums go through Lidarr.
- Aurral does not move artists, albums, or files between Aurral and Lidarr.
- Aurral keeps its own media in the Downloads Folder. Flow files use
_flows. Permanent tracks useArtist/Album/Trackfolders. - The Downloads Folder and a Lidarr root folder can overlap, but it is not recommended. See Settings warn that roots overlap.