Navidrome: Difference between revisions

Latest revision as of 06:21, 9 April 2026

Navidrome is a self-hosted music streaming server that allows users to manage and play their personal music collections from various devices. Designed with a user-friendly interface, it supports features like playlists, searching, and streaming, all while emphasizing privacy and data ownership.

Setup

Simply add to your system configuration and apply

services.navidrome = {
  enable = true;
  settings.MusicFolder = "/mnt/audio/music";
};

The service should be available add http://127.0.0.1:4533. Continue adding an admin login including setting a password.

Tips and tricks

Import playlists

Place m3u or m3u8 playlist files in a specific folder, configure it in the Navidrome service and after a library scan it should get imported. In this example the playlist files are stored in /mnt/audio/playlists.

services.navidrome = {
  enable = true;
  settings.PlaylistsPath = "/mnt/audio/playlists";
};

Enable sharing

Single tracks, albums or playlists can be publicly shared. To enable the feature, add

services.navidrome = {
  enable = true;
  settings.EnableSharing = true;
};

@@ Line 3: / Line 3: @@
 === Setup ===
 Simply add to your system configuration and apply<syntaxhighlight lang="nix">
-services.navidrome.enable = true;
+services.navidrome = {
+  enable = true;
+  settings.MusicFolder = "/mnt/audio/music";
+};
 </syntaxhighlight>The service should be available add http://127.0.0.1:4533. Continue adding an admin login including setting a password.
+=== Tips and tricks ===
+==== Import playlists ====
-If you have your music library outside of the systemd unit profile path, you'll add to have it to <code>BindReadOnlypaths</code><syntaxhighlight lang="nix">
+Place m3u or m3u8 playlist files in a specific folder, configure it in the Navidrome service and after a library scan it should get imported. In this example the playlist files are stored in <code>/mnt/audio/playlists</code>.
-systemd.services.navidrome.serviceConfig = {
-   BindReadOnlyPaths = [
+<syntaxhighlight lang="nix">
-    "/mnt/audio/music"
+services.navidrome = {
-  ];
+   enable = true;
+  settings.PlaylistsPath = "/mnt/audio/playlists";
 };
 </syntaxhighlight>
-=== Tips and tricks ===
+==== Enable sharing ====
+Single tracks, albums or playlists can be publicly shared. To enable the feature, add
-==== Enable sharing ====
+<syntaxhighlight lang="nix">
-Single tracks, albums or playlists can be publicly shared. To enable the feature, add<syntaxhighlight lang="nix">
 services.navidrome = {
    enable = true;