aurral

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
Self-hosted music discovery and request management for Lidarr with library-aware recommendations, granular monitoring controls, and optional Weekly Flow playlists powered by Soulseek + Navidrome.
Aurral

Release 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

Aurral Discover page

  • 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.

@bmikaili @booxter @Barosky @robertdistefano @pcsokonay @okcodemaybe @jakobbjelver @zachgonser @erleijen @bahraoui @nosooqua

Sponsored by Macroscope

Categories

Related apps

Explore more like this

Explore all

Links

Details

Repository
ghcr.io/lklynet/aurral:latest
Last Updated2026-11-22
First Seen2026-02-24

Runtime arguments

Web UI
http://[IP]:[PORT:3001]/
Network
bridge
Shell
sh
Privileged
false

Template configuration

WebUIPorttcp
Target
3001
Default
3001
Value
3001
AppdataPathrw
Target
/app/backend/data
Default
/mnt/user/appdata/aurral
Value
/mnt/user/appdata/aurral
Weekly Flow DownloadsPathrw

Where weekly flow will download. Delete if not needed.

Target
/app/downloads
DOWNLOAD_FOLDERVariable

Must match host path from Weekly Flow Downloads directory above. Delete if not needed.

PUIDVariable
Default
99
Value
99
PGIDVariable
Default
100
Value
100