Aurral Docs

Aurral is a self-hosted app for music discovery, downloads, and playback. It finds artists you do not have yet, downloads tracks for flows and imported playlists, and plays your library in the browser.

Get started

1. Install Aurral with Docker.
2. Set up the shared filesystem. Aurral must read the files that your other services write.
3. Complete first-run setup.
4. Connect the services that you use.

Note

Aurral keeps your music in its Library folder and manages it itself. Lidarr is optional: Aurral can play the music in Lidarr’s folders and download albums through Lidarr with a plugin.

How Aurral fits

Aurral indexes the music in its Library folder, and in read-only folders you add. This index is the Library. Aurral plays Library tracks in its built-in player and serves them to Subsonic clients. Navidrome, Plex, and Jellyfin can read the Library folder and Aurral’s playlist files.

Essential guides

Use the app

Discover, Search, Library, Playlists, Activity, Shows, and Settings. App overview

Create playlists

Build a scheduled flow or import a playlist. Playlists overview

Use Lidarr

Play Lidarr’s music and download through Lidarr. Lidarr

Run Aurral

Storage, users, environment variables, and troubleshooting. Administration

Links

• aurral.org
• GitHub
• Discord