ConfigsApr 16, 2026·3 min read

Navidrome — Self-Hosted Music Server & Streamer

Navidrome is a lightweight, self-hosted music server compatible with Subsonic clients, letting you stream your entire music collection from anywhere.

AI Open Source
AI Open Source · Community
TL;DR
Navidrome streams your music collection from your own server via Subsonic-compatible apps.
§01

What it is

Navidrome is a lightweight, self-hosted music server that lets you stream your entire music collection from anywhere. It is compatible with the Subsonic API, which means you can use dozens of existing Subsonic client apps on iOS, Android, desktop, and web. Navidrome handles library scanning, transcoding, playlist management, and multi-user access.

Navidrome targets music enthusiasts and homelab operators who want to own their music streaming experience. Instead of paying for a subscription service, you point Navidrome at your music folder and get a personal Spotify-like experience on your own hardware.

§02

Why it saves time or tokens

Setting up a music server traditionally required configuring Plex, Jellyfin, or Airsonic with their complex settings. Navidrome is a single binary or Docker container that scans your music directory and serves it immediately. The Subsonic API compatibility means you do not need to find or build custom client apps. Configuration is minimal: point at a folder, set a port, and start streaming.

§03

How to use

  1. Deploy Navidrome with Docker: docker run -d -p 4533:4533 -v /path/to/music:/music deluan/navidrome
  2. Open the web UI at http://your-server:4533 and create an admin account
  3. Connect a Subsonic-compatible client app on your phone or desktop
§04

Example

# docker-compose.yml
version: '3'
services:
  navidrome:
    image: deluan/navidrome:latest
    ports:
      - '4533:4533'
    environment:
      ND_SCANSCHEDULE: 1h
      ND_LOGLEVEL: info
      ND_BASEURL: ''
    volumes:
      - ./data:/data
      - /path/to/music:/music:ro
    restart: unless-stopped
FeatureDescription
Library scanningAutomatic periodic scan with metadata
TranscodingOn-the-fly format conversion
Multi-userIndividual libraries and playlists
Subsonic APICompatible with 30+ client apps
Web UIBuilt-in responsive web player
§05

Related on TokRepo

§06

Common pitfalls

  • Music files without proper ID3 tags display as unknown artist/album; tag your library with MusicBrainz Picard before importing
  • Transcoding requires ffmpeg installed alongside Navidrome; the Docker image includes it, but bare-metal installs may need manual setup
  • Exposing Navidrome to the internet requires a reverse proxy with TLS; never run it on a public port without HTTPS

Frequently Asked Questions

What client apps work with Navidrome?+

Navidrome supports the Subsonic API, which is compatible with apps like DSub and Ultrasonic on Android, play:Sub and Amperfy on iOS, Sonixd and Sublime Music on desktop, and many others. The Navidrome documentation maintains a list of tested compatible clients across all platforms.

How does Navidrome compare to Jellyfin for music?+

Jellyfin is a general-purpose media server handling video, music, and photos. Navidrome is purpose-built for music only, resulting in a simpler setup and better music-specific features like smart playlists and Subsonic API compatibility. If you only need music streaming, Navidrome is the lighter choice.

Does Navidrome support multiple users?+

Yes. Navidrome supports multiple users, each with their own playlists, favorites, play history, and access controls. The admin can manage user accounts through the web interface. Each user connects with their own credentials from any Subsonic client.

What audio formats does Navidrome support?+

Navidrome supports MP3, FLAC, OGG, AAC, WMA, WAV, AIFF, and other common formats. For formats your client cannot play natively, Navidrome transcodes on the fly using ffmpeg. You can configure the target transcode format and bitrate per user or globally.

Can I access Navidrome from outside my home network?+

Yes. Set up a reverse proxy (Nginx, Caddy, or Traefik) with a domain name and TLS certificate to expose Navidrome securely. Alternatively, use a VPN like WireGuard or Tailscale to access your home network. Never expose Navidrome directly without encryption.

Citations (3)
Related on TokRepo
Self-hosted toolsAutomation toolsFeatured workflows

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets

Conda — Cross-Platform Package and Environment Manager

Install, update, and manage packages and isolated environments for Python, R, C/C++, and hundreds of other languages from a single tool.

AI Open Source

Sphinx — Python Documentation Generator

Generate professional documentation from reStructuredText and Markdown with cross-references, API autodoc, and multiple output formats.

AI Open Source

Neutralinojs — Lightweight Cross-Platform Desktop Apps

Build desktop applications with HTML, CSS, and JavaScript using a tiny native runtime instead of bundling Chromium.

AI Open Source
◈Home🔍Search👤Me