Navidrome is an open source web-based music collection server and streamer. It gives you freedom to listen to your music collection from any browser or mobile device. It's like your personal Spotify!

Note: The master branch may be in an unstable or even broken state during development. Please use releases instead of the master branch in order to get a stable set of binaries.

Any feedback is welcome! If you need/want a new feature, find a bug or think of any way to improve Navidrome, please file a GitHub issue or join the discussion in our Subreddit. If you want to contribute to the project in any other way (ui/backend dev, translations, themes), please join the chat in our Discord server.

Local Development

The easiest way to run the full stack locally is with Docker Compose. It starts the Go backend and Vite frontend as separate services with hot-reload enabled.

Prerequisites: Docker and Docker Compose.

# First run — builds the Go image and downloads all dependencies
docker compose -f docker-compose.dev.yml up --build

# Subsequent runs
docker compose -f docker-compose.dev.yml up

Open http://localhost:4533.

Default credentials

Username	Password
`admin`	`admin`

Adding music

Place your audio files in the music/ folder at the project root. If the folder doesn't exist yet, create it first:

mkdir music

The scanner picks up new files automatically.

# Run in the background
docker compose -f docker-compose.dev.yml up -d

# Follow logs
docker compose -f docker-compose.dev.yml logs -f

# Stop
docker compose -f docker-compose.dev.yml down

Both services support hot-reload: editing .go files restarts the backend via reflex, and editing frontend source triggers Vite's HMR.

Inspecting the database

Open a SQLite shell inside the running backend container:

docker compose -f docker-compose.dev.yml exec backend sqlite3 /data/navidrome.db

Useful commands once inside:

.tables               -- list all tables
.schema media_file    -- show a table's schema
SELECT * FROM user;   -- query data
.quit                 -- exit

Installation

See instructions on the project's website

Cloud Hosting

PikaPods has partnered with us to offer you an officially supported, cloud-hosted solution. A share of the revenue helps fund the development of Navidrome at no additional cost for you.

Features

Handles very large music collections
Streams virtually any audio format available
Reads and uses all your beautifully curated metadata
Great support for compilations (Various Artists albums) and box sets (multi-disc albums)
Multi-user, each user has their own play counts, playlists, favourites, etc...
Very low resource usage
Multi-platform, runs on macOS, Linux and Windows. Docker images are also provided
Ready to use binaries for all major platforms, including Raspberry Pi
Automatically monitors your library for changes, importing new files and reloading new metadata
Supports lyrics from sidecar .ttml, .yaml/.yml Lyricsfile, .elrc, .lrc, .srt, .txt files and embedded TTML, Enhanced LRC, LRC, SRT, and plain-text tags (via lyricspriority)
Themeable, modern and responsive Web interface based on Material UI
Compatible with all Subsonic/Madsonic/Airsonic clients
Transcoding on the fly. Can be set per user/player. Opus encoding is supported
Translated to various languages