Navidrome

A self-hosted music server that streams your personal music collection to any device. Compatible with all Subsonic/Airsonic API clients, so you can use dozens of third-party apps on mobile and desktop.

What You Can Do After Deployment

1. Visit your domain — on first access, you'll create an admin account (username + password)
2. Upload music — place audio files in the /music volume; Navidrome automatically scans and indexes them (this template sets the scan interval to every 1 hour via ND_SCANNER_SCHEDULE)
3. Play in browser — the built-in web player shows album art and lets you browse by artist, album, genre, or playlist
4. Connect mobile/desktop apps — use any Subsonic-compatible client (DSub, Symfonium, play:Sub, Audinaut, Sublime Music, etc.) with your domain URL and credentials
5. Set up scrobbling (optional) — connect your Last.fm or ListenBrainz account to track listening history

Key Features

• Modern, responsive web UI with album art display
• Compatible with Subsonic/Airsonic API — works with dozens of mobile and desktop apps
• On-the-fly audio transcoding with per-user and per-player settings (supports MP3, FLAC, AAC, OGG, Opus, and more)
• Multi-user support — each user has their own play counts, playlists, favorites, and settings
• Smart playlists, favorites, and play history
• Last.fm and ListenBrainz scrobbling
• Lightweight — written in Go, low resource usage

Music Library

The /music volume is where your music library is stored. Navidrome automatically monitors this directory for changes and imports new files. Supported formats include MP3, FLAC, AAC, OGG, WMA, and virtually all common audio formats.

Configuration

• ND_SCANNER_SCHEDULE — how often to scan for new music (set to 1h by this template; Navidrome's upstream default is disabled)
• ND_LOGLEVEL — logging verbosity (default: info)
• ND_SESSIONTIMEOUT — session duration (default: 24h)

License

GPL-3.0 — GitHub | Website