Self-Hosted / Projects / Navidrome Music Server

Navidrome Music Server

Stable

navidrome/navidrome24.1k1.8k1d agoMedia Streaming - Audio Streaming

Specs verified August 30, 2026 · against v0.63.2

Overview

Self-hosted music server for personal streaming, Subsonic-compatible apps, and lightweight homelab deployment.

Navidrome is a self-hosted music server for people who want Spotify-style access to their own music collection without giving up file ownership or depending on a vendor cloud.

Why people choose Navidrome

The official website and docs position Navidrome as lightweight, fast, and compatible with a wide Subsonic and OpenSubsonic client ecosystem. It is popular with self-hosters who want music streaming on old hardware, Raspberry Pi, or small Docker hosts without the overhead of a larger media suite.

What is included in the stack

Official docs cover the built-in web player, support for large libraries, multi-user access, multi-library separation, playlists, smart playlists, transcoding, sharing, Last.fm and ListenBrainz scrobbling, and compatibility with many third-party clients on mobile, desktop, car, and TV platforms.

What to know before you deploy

Navidrome is excellent when you already own and organize your music, but it is not a discovery service like Spotify. The Docker docs also stress that the two most common setup failures are permissions on /data and unreadable /music mounts, and they explicitly warn that PUID and PGID environment variables do nothing for the official image.

Best fit

Choose Navidrome when you want a fast self-hosted music streaming layer for your own files and you like the flexibility of picking your own client apps. If you want one app that also handles movies, shows, or live TV, compare it with broader media-server stacks instead.

Quick deploy

Paste into docker-compose.yml and run docker compose up -d

docker-compose.yml

1services:
2  navidrome:
3    image: deluan/navidrome:latest
4    user: 1000:1000
5    ports:
6      - "4533:4533"
7    restart: unless-stopped
8    volumes:
9      - "/path/to/data:/data"
10      - "/path/to/music:/music:ro"

Configuration

Environment variables

Variable	What it does	Example
`ND_LOGLEVEL`	Optional Navidrome log level.	info
`ND_CONFIGFILE`	Optional path to a navidrome.toml configuration file inside /data.	/data/navidrome.toml

Ports

4533/tcp — Navidrome web interface and streaming API

Volumes to back up

/data — Writable Navidrome data, cache, and database path.
/music — Read-only mounted music library.

Interface previews

Feature support

Feature support in Navidrome Music Server
Feature	Support
Web player for personal music librariesOfficial docs say Navidrome can be used as a standalone server with a modern web interface.	Supported
Subsonic and OpenSubsonic client compatibilityThe project documents compatibility with the broader Subsonic client ecosystem across mobile and desktop apps.	Supported
Very low resource usageOfficial docs say it runs well even on simple Raspberry Pi and older hardware.	Supported
Large-library supportThe official site says Navidrome has been tested with very large collections.	Supported
Multi-user and multi-library supportThe docs describe per-user stats, playlists, favorites, and library-specific access controls.	Supported
On-the-fly transcodingOfficial docs say Navidrome can transcode on the fly and support Opus encoding.	Supported
Smart playlists and sharing linksThe overview docs list smart playlists and public sharing for albums, songs, and playlists.	Supported
Docker deploymentOfficial Docker docs provide a supported container workflow with explicit user and volume guidance.	Supported

Community signals

Stars: 24.1k
Forks: 1.8k
Open issues: 302
Last commit: 1d ago
Latest release: v0.64.2
Repo created: Feb 2016

Refreshed nightly from the GitHub API.

Questions

What is Navidrome used for?

Navidrome is used to stream and manage your own music library through a self-hosted web app and compatible mobile or desktop clients.

Can Navidrome replace Spotify?

It can replace the personal streaming part if you already own your music library, but it is not a cloud discovery catalog like Spotify.

Does Navidrome support mobile apps?

Yes. Official docs say it works with a wide ecosystem of Subsonic and OpenSubsonic clients on iOS and Android.

Can Navidrome run on Raspberry Pi?

Yes. Official docs say it runs well on simple Raspberry Pi hardware and provides official Raspberry Pi binaries and Docker images.

Does Navidrome support Docker?

Yes. The official Docker docs provide a compose example and explain the required /data and /music mounts.

What is the most common Navidrome deployment pitfall?

The official Docker docs say permission problems on the writable /data path and readable /music path are common causes of startup failure or an empty library.

Does Navidrome support more than one music library?

Yes. The official multi-library docs say you can create multiple libraries with user-specific access controls.

support // the lab

Found this write-up useful?

If it saved you time or a rebuild, you can support more practical homelab guides.

Support the lab