aurral
Docker app from JPDVM2014's Repository
Self-hosted music discovery and request management for Lidarr with library-aware recommendations, granular monitoring controls, and optional Weekly Flow playlists powered by…
Overview
Readme
View on GitHubRelease Downloads Discord Sponsor
Self-hosted music that doesn't feel like a chore. One container, zero API keys, and you own every file.
Website · Docs · FAQ · Discord · Sponsor · Buy me a coffee
- Discover artists you'll like, with a real reason for every pick. Bootstrap straight from your Spotify history.
- Flows turn your taste into scheduled playlists that grab their own tracks and rotate on autopilot. Daily mixes build from what you play.
- Import playlists from Spotify, YouTube Music, Last.fm, ListenBrainz, and M3U files.
- Library managed for you, with real audio verification, automatic tagging, and read-only folder support for music you don't want touched.
- Listen with synced lyrics and radio in the built-in player, from anywhere at music.aurral.org, or in any Subsonic app. Already on Navidrome, Plex, or Jellyfin? Aurral writes M3U playlists and plays nice with all of them.
- Friends see what people on your server and your aurral.org friends are playing, and Blends mix your taste with theirs.
- Share tracks, albums, and playlists as links, publish public playlists, or let friends play straight from your Library.
- Plugins add download sources, imports, and actions when you want them.
Connect slskd, Usenet, qBittorrent, Tidarr, deemix, or download plugins for lossless music, with built-in yt-dlp ready as a fallback out of the box. Every integration is optional. Read the docs for the full tour, or check the FAQ.
Quick start
services:
aurral:
image: ghcr.io/lklynet/aurral:latest
restart: unless-stopped
ports:
- "3001:3001"
environment:
- PUID=1000
- PGID=1000
volumes:
- ./config:/config
- ./data:/data
Run docker compose up -d, open http://localhost:3001, and create your admin account. No companion containers required to start. Want the latest changes early? Use the nightly tag.
Thanks
Built on open music data from MetaBrainz (MusicBrainz, ListenBrainz, and the Cover Art Archive) via AurralBrainz. Chat on Discord, report bugs in Issues.
Sponsors
Aurral is free, MIT licensed, and has no paywalled pro tier. Sponsors and coffees pay for AurralBrainz, the hosted metadata server, and keep it that way.
Categories
Related apps
Explore more like this
Explore allLinks
Details
ghcr.io/lklynet/aurral:latestRuntime arguments
- Web UI
http://[IP]:[PORT:3001]/- Network
bridge- Shell
sh- Privileged
- false
Template configuration
- Target
- 3001
- Default
- 3001
- Value
- 3001
- Target
- /app/backend/data
- Default
- /mnt/user/appdata/aurral
- Value
- /mnt/user/appdata/aurral
Where weekly flow will download. Delete if not needed.
- Target
- /app/downloads
Must match host path from Weekly Flow Downloads directory above. Delete if not needed.
- Default
- 99
- Value
- 99
- Default
- 100
- Value
- 100










