SkillsApr 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
Agent ready

Ready-to-run agent install

This asset can be installed after the agent chooses its runtime, checks the plan, and runs the matching command.

Native · 98/100Policy: allow
Agent surface
Any MCP/CLI agent
Kind
Skill
Install
Single
Trust
Trust: Established
Entrypoint
Navidrome Overview
Direct install command
npx -y tokrepo@latest install a70ba942-39c1-11f1-9bc6-00163e2b0d79 --target codex

Run after dry-run confirms the install plan.

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

Owncast — Self-Hosted Live Streaming Server

An open source, self-hosted, decentralized live video streaming and chat server that gives you full control over your broadcasts.

Skills
AI Open Source

Homarr — Customizable Self-Hosted Server Dashboard

Homarr is a sleek, modern dashboard for your self-hosted server that integrates with dozens of services. It provides real-time monitoring widgets, application shortcuts, and Docker container management in one unified interface.

Skills
AI Open Source

Cosmos Server — Secure Self-Hosted Home Server Platform

A secure self-hosted home server platform with built-in reverse proxy, authentication, anti-DDoS protection, and a container management UI for running self-hosted applications safely.

Skills
AI Open Source

Tube Archivist — Self-Hosted YouTube Media Server

A self-hosted YouTube media server that downloads, indexes, and organizes YouTube videos. Tube Archivist provides a browsable archive with search, subscriptions, and playback.

Skills
AI Open Source
◈Home🔍Search👤Me