Navidrome: streaming, from your own shelves
If your music still lives as files — rips, Bandcamp purchases, the library you refuse to rent back from a streaming service — Navidrome is how it behaves like Spotify anyway: instant streaming to any Subsonic-compatible app, smart playlists, multi-user accounts, and a scanner efficient enough to make light work of most libraries. It is the most-loved gap in our self-hosting catalog, and it pairs with Music Assistant in a way that covers both personal listening and whole-home playback.
Published Nov 18, 2026
Deploy it
services:
navidrome:
image: deluan/navidrome:latest
container_name: navidrome
ports:
- "4533:4533"
environment:
- ND_SCANSCHEDULE=1h
- ND_LOGLEVEL=info
volumes:
- ./navidrome/data:/data
- /volume1/music:/music:ro # read-only: Navidrome never modifies your files
restart: unless-stopped
First run creates the admin account in the web UI, and you are listening. Navidrome's scanner is famously efficient, but the initial scan is not instant by magic: how long it takes depends on the size of your library, your storage's speed, and how much metadata each file carries — a huge, tag-heavy library on spinning disks earns itself a coffee break, while later incremental scans are quick. The read-only music mount is deliberate and worth copying: Navidrome manages its own database and cache, and your files stay pristine — the same respect-originals philosophy as Immich's.
One caution about that port line: "4533:4533" publishes Navidrome on the NAS's network interfaces. On your home LAN that is exactly what you want — but it is not, by itself, secure access from the internet. For listening away from home, reach it through a VPN (Tailscale or WireGuard) or a properly configured HTTPS reverse proxy, as in our remote access comparison. Do not forward port 4533 directly from your router.
Clients: the Subsonic dividend
Navidrome speaks the Subsonic API, which means a decade of clients works with it: excellent mobile apps (Symfonium on Android is the community favorite; play:Sub and Amperfy on iOS), desktop players, web UI for everywhere else, and offline downloads inside those apps for flights and dead zones. Set up each household member with their own account — favorites, playlists and play counts are per-user, and the 'year in review' arguments can finally be settled with data.
Playlists, smart and otherwise
- Smart playlists are rule-based and self-updating ('added in the last 90 days,' 'never played favorites,' 'everything tagged live') — the feature ex-streaming users miss most, done better than the services do it.
- Radio & discovery: Navidrome generates artist radio and surfaces forgotten corners of your own collection — discovery within ownership.
- Sharing: generate a public link to an album or playlist for a friend (expiring, revocable) without giving them an account — the mixtape, restored.
Navidrome + Music Assistant: the complete picture
These two are complements, not rivals. Navidrome is the personal streaming service — phones, cars, headphones, offline. Music Assistant (our beginner's guide) is the whole-home conductor — speakers in rooms, voice requests, grouping. Music Assistant can use your Navidrome library as a source, so the same shelves feed both: ask the kitchen speaker for an album (Music Assistant serves it from Navidrome's library) and continue it in the car (the Navidrome app picks up your account). One library, two front doors, zero subscriptions — the self-hosted music story, complete.
Library care
- Tags are the product: Navidrome lives and dies by your files' metadata. A one-time pass with a tagger (MusicBrainz Picard is the standard) pays dividends forever.
- Folder structure: Artist/Album/Track is all it asks; it reads tags for the rest.
- Backups: the /data volume holds users, playlists and play counts — the irreplaceable part. The music files are re-rippable; your decade of favorites is not. It belongs in your backup strategy.
Official documentation and references
- Navidrome documentation — the official docs home
- Navidrome documentation — installation options
- Navidrome documentation — configuration options
- Navidrome on GitHub — the official repository
Frequently asked questions
Does Navidrome work with my existing music files?
Yes — it scans standard formats (MP3, FLAC, AAC, Opus and more) read-only and builds its library from your tags. Your files are never modified.
What app should I use on my phone?
Any Subsonic client: Symfonium (Android) and play:Sub or Amperfy (iOS) are the community favorites, with offline download support for travel. The built-in web player covers desktop in a pinch.
Navidrome or Music Assistant?
Both, for different jobs: Navidrome for personal streaming anywhere, Music Assistant for whole-home speaker playback and voice. Music Assistant can source from your Navidrome library, so they compose rather than compete.

