Zum Inhalt springen
Serverküche
Suche

Die Suche wird geladen …

Anwendungen Schwierigkeit: Fortgeschritten

Navidrome: die eigene Musik streamen wie mit Spotify

Deine Musiksammlung von überall streamen – ohne Abo und Tracking: Navidrome hinter Traefik, mit App-Anbindung über den Subsonic-Standard und Backup.

· Zuletzt aktualisiert: · 11 Min. Lesezeit ·Dauer: ca. 50 Minuten
Inhaltsverzeichnis

Deine mühsam zusammengetragene Musiksammlung liegt auf einer Festplatte, während du unterwegs Spotify zahlst? Navidrome macht deine eigenen Dateien zu einem Streaming-Dienst: Weboberfläche, mobile Apps, überall Zugriff – und niemand wertet aus, was du hörst.

Was bauen wir?

Einen persönlichen Musik-Streaming-Server mit Navidrome (v0.64.2) hinter Traefik. Am Ende durchsuchst du deine Sammlung im Browser nach Alben, Künstlern und Genres, streamst on-demand – und bindest über den Subsonic-Standard die App deiner Wahl (Symfonium, DSub, play:Sub …) an, um auch unterwegs zu hören. Dazu legen wir eigene Konten für Mitbewohner an, richten Transcoding fürs Mobilfunknetz ein und lassen Navidrome seine Datenbank selbst sichern.

Navidrome ist in Go geschrieben und entsprechend genügsam. Auf einem netcup-VPS zeigt docker stats für den laufenden Container rund 48 MiB RAM bei unter 1 % CPU – die Musiksammlung selbst ist der Posten, der Platz braucht, nicht der Server.

Für Hörbücher und Podcasts ist es dagegen das falsche Werkzeug: Navidrome denkt in Alben und Titeln, nicht in Kapiteln, und merkt sich keine Hörposition über Geräte hinweg. Dafür gibt es Audiobookshelf – beide lassen sich problemlos parallel betreiben.

Voraussetzungen

  • Ein Server mit laufendem Traefik und Docker Compose
  • Eine Subdomain, die auf den Server zeigt – im Folgenden DEINE_DOMAIN
  • Deine Musikdateien (MP3, FLAC, …) mit ordentlichen Metadaten (Tags) – daraus baut Navidrome die Bibliothek
  • Genug Plattenplatz für die Sammlung: eine Stunde MP3 mit 320 kbit/s belegt rund 140 MB, dieselbe Stunde als FLAC je nach Material das Zwei- bis Dreifache
🍳 Empfehlung Anzeige

VPS 1000 G12.5

4 vCore · 8 GB RAM · 128 GB SSD

ab 14,50 €/Monat

Navidrome ist genügsam; für große Sammlungen zählt vor allem der Speicherplatz.

Zu netcup →

💶 1 Monat gratis:

Einmal einlösbar, gilt für VPS 1000 G12.5. Im Warenkorb einlösen →

💶 5,95 € Gutschein für netcup-Neukunden: immer gültig · nicht für Domains und VPS Lite

Alle netcup-Gutscheine →

Schritt für Schritt

Schritt 1: Projekt anlegen

Navidrome braucht zwei Ordner: einen für die Musik (nur lesend) und einen für seine Datenbank/Index. Lege das Projekt an:

Terminal
mkdir -p /opt/navidrome/data /opt/navidrome/music && cd /opt/navidrome

Der Container läuft gleich nicht als root, sondern unter der UID 1000 – das ist der übliche erste Nutzer auf einem Debian-System und sorgt dafür, dass Navidrome nur an die eigenen Dateien kommt (mehr dazu in Benutzer & Rechte). Damit der Prozess seine Datenbank schreiben darf, muss ihm das Verzeichnis auch gehören:

Terminal
chown -R 1000:1000 /opt/navidrome

Schritt 2: Musik auf den Server bringen

Kopiere deine Musik in den music-Ordner – am besten sauber strukturiert (Künstler/Album/Titel.mp3). Für die Übertragung eignet sich rsync über SSH:

Terminal
rsync -av --progress ~/Musik/ root@DEINE_SERVER_IP:/opt/navidrome/music/

Wichtig sind gute Metadaten: Navidrome liest Künstler, Album, Titel, Jahr und Cover aus den Tags der Dateien, nicht aus den Dateinamen. Schlecht getaggte Dateien landen unsortiert in der Bibliothek. Die Ordnerstruktur ist trotzdem nicht egal – Navidrome verarbeitet den Bestand ordnerweise und protokolliert das auch so.

Um die Formate musst du dir wenig Sorgen machen: MP3, FLAC und Opus aus demselben Ordner liest Navidrome anstandslos ein. Vergiss nach dem Kopieren die Rechte nicht, sonst sieht der Container die neuen Dateien nicht:

Terminal
chown -R 1000:1000 /opt/navidrome/music

Schritt 3: Compose-Datei

Ersetze DEINE_DOMAIN:

YAML
services:
  navidrome:
    image: deluan/navidrome:0.64.2
    restart: unless-stopped
    user: "1000:1000"
    environment:
      ND_MUSICFOLDER: /music
      ND_DATAFOLDER: /data
      ND_SCANNER_SCHEDULE: 1h        # stündlich nach neuen Dateien suchen
      ND_BACKUP_PATH: /data/backup   # Navidrome sichert seine Datenbank selbst
      ND_BACKUP_SCHEDULE: "0 4 * * *"
      ND_BACKUP_COUNT: 7
    volumes:
      - ./data:/data
      - ./music:/music:ro        # Musik nur lesend einbinden
    networks: [proxy]
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.navidrome.rule=Host(`DEINE_DOMAIN`)"
      - "traefik.http.routers.navidrome.entrypoints=websecure"
      - "traefik.http.routers.navidrome.tls.certresolver=le"
      - "traefik.http.routers.navidrome.middlewares=navidrome-nur-ich"
      - "traefik.http.middlewares.navidrome-nur-ich.ipallowlist.sourcerange=DEINE_IPV4/32,DEIN_IPV6_PRAEFIX::/64"
      - "traefik.http.services.navidrome.loadbalancer.server.port=4533"

networks:
  proxy:
    external: true

Das :ro am Musik-Volume ist bewusst: Navidrome soll deine Dateien nur lesen, nie verändern. ND_SCANNER_SCHEDULE: 1h lässt es stündlich nach neuer Musik suchen.

Die drei ND_BACKUP_*-Zeilen schalten Navidromes eingebaute Datenbanksicherung ein: Es legt nachts um 4 Uhr eine konsistente Kopie seiner SQLite-Datenbank in /data/backup und hält die letzten sieben Stände vor. Den Ordner erzeugt Navidrome beim ersten Lauf selbst. Das kostet fast nichts und rettet dir Playlists, Nutzerkonten und Abspielstatistiken, wenn beim Update etwas schiefgeht – Details dazu in „Wartung & Backups".

navidrome-nur-ich lässt bis zum Ende der Einrichtung nur deine eigene Adresse durch, alle anderen bekommen 403 Forbidden. Solange noch kein Admin-Konto existiert, gehört die Instanz sonst dem, der die Seite zuerst aufruft – und Scanner finden neue Hostnamen über die öffentlichen Zertifikats-Logs mitunter schon Sekunden nach dem Start. Deine Adressen fragst du auf deinem eigenen Rechner ab, nicht auf dem Server: curl -4 -s https://ifconfig.me für die IPv4, curl -6 -s https://ifconfig.me für die IPv6 (davon die ersten vier Blöcke). Hast du kein IPv6, lass den zweiten Eintrag samt Komma weg – aber nur dann: Browser gehen bevorzugt per IPv6, und eine reine IPv4-Liste sperrt dich selbst aus. Mehr dazu in Traefik härten.

Schritt 4: Starten und den Scan prüfen

Terminal
docker compose up -d

Navidrome scannt beim ersten Start die Bibliothek. Das kannst du im Log verfolgen – --no-log-prefix blendet den vorangestellten Containernamen aus, sonst wird jede Zeile unnötig breit:

Terminal
docker compose logs --no-log-prefix | grep "Scanner:"
Ausgabe
time="2026-09-30T23:48:38Z" level=info msg="Scanner: Starting scan" fullScan=true numLibraries=1
time="2026-09-30T23:48:39Z" level=info msg="Scanner: Completed processing folder" audioCount=1 elapsed=318.9ms imageCount=0 library="Music Library" plsCount=0 tracksImported=1 tracksMissing=0 folder="DJ Backup/Cronjobs"
time="2026-09-30T23:48:39Z" level=info msg="Scanner: Completed processing folder" audioCount=2 elapsed=318.1ms imageCount=0 library="Music Library" plsCount=0 tracksImported=2 tracksMissing=0 folder="Serverkueche Quartett/Kuechenklaenge"
time="2026-09-30T23:48:39Z" level=info msg="Scanner: Finished scanning all libraries" duration=333.7ms

Für jeden Ordner kommt eine eigene Zeile (die der leeren Künstler-Ordner sind hier weggelassen). tracksImported zeigt, wie viele Titel dort erkannt wurden – in diesem Beispiel drei insgesamt. Bei großen Sammlungen dauert der erste Scan entsprechend länger; die Zeile Finished scanning all libraries markiert das Ende.

Dass die Sicherung eingerichtet ist, siehst du im selben Log:

Terminal
docker compose logs --no-log-prefix | grep "periodic backup"
Ausgabe
time="2026-09-30T23:48:36Z" level=info msg="Scheduling periodic backup" schedule="0 4 * * *"

Schritt 5: Admin-Konto anlegen

Öffne https://DEINE_DOMAIN/. Beim ersten Aufruf legst du das Administrator-Konto an:

Der Navidrome-Ersteinrichtungsbildschirm zum Anlegen des Admin-Kontos
Beim ersten Start legst du Benutzername und Passwort des Admins fest

Vergib einen Benutzernamen und ein starkes Passwort. Die Oberfläche steht offen im Netz, und das Admin-Konto ist der einzige Schutz davor – nimm hier keinen Namen, den du schon woanders nutzt. Danach landest du direkt in deiner Bibliothek.

Den Wizard nicht offen stehen lassen

Bis der Admin angelegt ist, kann jeder, der die Seite erreicht, das erste Konto anlegen. Die Sperre navidrome-nur-ich aus Schritt 3 schließt dieses Fenster – nimm sie deshalb erst danach heraus.

Ist das Admin-Konto angelegt, nimm die Sperre wieder heraus: Lösch in der compose.yaml die beiden Zeilen mit navidrome-nur-ich und übernimm die Änderung:

Terminal
docker compose up -d

Schritt 6: Durch die Bibliothek stöbern

Die Weboberfläche zeigt deine Musik nach Alben, Künstlern, Genres und zuletzt Hinzugefügtem – mit Cover-Rastern und Suche:

Die Navidrome-Albenübersicht mit den erkannten Alben und Künstlern
Die Bibliothek: Alben mit Cover, Künstler und Filtermöglichkeiten

Ein Klick auf ein Album öffnet die Titelliste; ein Doppelklick auf einen Titel startet die Wiedergabe im eingebauten Player unten:

Ein geöffnetes Album mit Titelliste und dem laufenden Player am unteren Rand
Album-Ansicht mit Titelliste – unten spielt der eingebaute Player gerade den ersten Titel

Über die Leiste links wechselst du zwischen Alben, Künstlern, Titeln und den automatischen Listen („Recently Added", „Most Played"); das Suchfeld und ADD FILTER schränken die jeweilige Ansicht weiter ein. Das Aktualisieren-Symbol oben rechts stößt einen sofortigen Scan an, wenn du nicht bis zum nächsten Intervall warten willst.

Schritt 7: Konten für Mitbewohner und Familie

Teile nicht das Admin-Konto. Wer mithört, bekommt ein eigenes – dann hat jeder eigene Playlists, Favoriten und Abspielstatistiken, und niemand kann versehentlich an den Servereinstellungen drehen. Das Konto legst du in der Oberfläche unter Users über CREATE an:

Das Formular zum Anlegen eines neuen Navidrome-Nutzers mit Benutzername, Passwort und Bibliotheksauswahl
Neues Konto: Benutzername, Passwort – und der Schalter „Is Admin“ bleibt aus

Der Schalter Is Admin bleibt dabei aus. Unter Libraries wählst du aus, welche Bibliotheken das Konto sehen darf; lässt du die Auswahl leer, gelten die Standardbibliotheken. Jedes dieser Konten funktioniert anschließend genauso in den mobilen Apps.

Schritt 8: Mobile Apps über Subsonic anbinden

Navidrome spricht die Subsonic-API – einen etablierten Standard, den viele Musik-Apps unterstützen. So hörst du deine Sammlung unterwegs mit der App deiner Wahl. In der App gibst du an:

  • Server: https://DEINE_DOMAIN
  • Benutzername/Passwort: dein Navidrome-Konto

Empfehlenswerte Apps: Symfonium oder Tempo (Android), play:Sub oder substreamer (iOS). Der Vorteil eines offenen Standards: Gefällt dir eine App nicht, tauschst du sie aus, ohne am Server etwas zu ändern. Navidrome meldet sich dabei als OpenSubsonic-Server – eine Erweiterung des alten Subsonic-Protokolls, mit der neuere Apps zusätzlich Dinge wie Songtexte oder erweiterte Metadaten abfragen können.

Ob die API überhaupt antwortet, prüfst du ohne App mit einem einzigen Aufruf – die Fehlermeldung zum fehlenden Benutzer ist dabei genau das erwartete Ergebnis:

Terminal
curl -s "https://DEINE_DOMAIN/rest/ping.view?v=1.16.1&c=test&f=json"
Ausgabe
{"subsonic-response":{"status":"failed","version":"1.16.1","type":"navidrome","serverVersion":"0.64.2 (10114574)","openSubsonic":true,"error":{"code":10,"message":"missing parameter: 'u'"}}}

Kommt diese Antwort, stimmen Domain, Zertifikat und Traefik-Route – dann liegt ein Verbindungsproblem an den Zugangsdaten oder an der App.

Schritt 9: Transcoding fürs Mobilfunknetz einrichten

FLAC-Dateien in voller Auflösung über eine wacklige Mobilfunkverbindung zu ziehen, endet in Aussetzern und aufgebrauchtem Datenvolumen. Navidrome kann den Stream deshalb unterwegs kleinrechnen (Transcoding) – das nötige ffmpeg bringt das Image bereits mit, du musst nichts nachinstallieren.

Eingestellt wird das pro Player, nicht pro Konto: Jede App, die sich einmal verbunden hat, taucht in der Oberfläche unter Players als eigener Eintrag auf. Öffne ihn und setze Transcoding und Max. Bit Rate:

Die Player-Einstellungen in Navidrome mit gesetztem Transcoding-Profil und maximaler Bitrate
Pro Player: Transcoding-Profil „mp3 audio“ und 128 kbit/s als Obergrenze

Zur Auswahl stehen die Profile aac audio, flac audio, mp3 audio und opus audio sowie Bitraten von 32 bis 320 kbit/s. mp3 audio mit 128 kbit/s ist ein guter Kompromiss für unterwegs und läuft auf jedem Gerät.

Dass es wirkt, kannst du nachmessen: Ein Titel, der als Original mit 48.693 Byte über die Leitung geht, kommt mit einer Obergrenze von 32 kbit/s nur noch mit 24.349 Byte an – halbes Datenvolumen, unveränderte Originaldatei auf der Platte. Den Player für den Browser lässt du einfach ohne Transcoding, dann hörst du zu Hause weiterhin in voller Qualität.

Wenn es nicht funktioniert

Die Seite antwortet mit 403 Forbidden. Die Sperre aus Schritt 3 lässt deine Adresse nicht durch. Meist fehlt die IPv6 oder sie hat sich geändert – frag beide Adressen erneut ab (siehe dort), korrigiere sourcerange und starte mit docker compose up -d neu.

Die Bibliothek bleibt leer. Entweder liegen keine Dateien im gemounteten music-Ordner, oder die Rechte stimmen nicht. Prüfe: docker compose logs --no-log-prefix | grep "Scanner:" zeigt tracksImported. Ist es überall 0, kontrolliere den Pfad und dass der music-Ordner UID 1000 gehört (siehe Benutzer & Rechte).

Titel erscheinen unsortiert oder ohne Cover. Die Metadaten der Dateien sind unvollständig – Navidrome sortiert nach Tags, nicht nach Dateinamen. Was es in einer Datei tatsächlich liest, zeigt dir docker compose exec navidrome /app/navidrome inspect "/music/Künstler/Album/Titel.mp3": Unter rawTags stehen die Tags so, wie sie in der Datei stehen. Fehlen dort album oder albumartist, tagge die Dateien nach (z. B. mit Picard) und lass Navidrome erneut scannen.

Neue Musik taucht nicht auf. Der Scan läuft nur stündlich (ND_SCANNER_SCHEDULE). Einen sofortigen Scan stößt du in der Weboberfläche über das Aktualisieren-Symbol oben rechts an, oder du wartest bis zum nächsten Intervall. Wurden die Dateien frisch hochgeladen, fehlt oft schlicht das chown -R 1000:1000 aus Schritt 2.

Die App verbindet sich nicht. Fast immer die Server-URL: Sie muss https://DEINE_DOMAIN lauten (mit https://, ohne Pfad). Antwortet der ping.view-Aufruf aus Schritt 8 sauber, liegt es an den Zugangsdaten – seit Version 0.64.1 bremst Navidrome wiederholte Fehlanmeldungen über die Subsonic-API zusätzlich aus, nach mehreren Tippfehlern lohnt also eine kurze Pause.

Wiedergabe stockt bei großen FLAC-Dateien mobil. Die Bandbreite reicht nicht fürs Original. Setze für den Player deiner App ein Transcoding-Profil und eine Obergrenze (Schritt 9) – der Eintrag erscheint unter Players erst, nachdem sich die App einmal verbunden hat.

Dein Problem ist nicht dabei? Alle Fehlermeldungen durchsuchen →

Wartung & Backups

  • Updates. Setze den Image-Tag (deluan/navidrome:0.64.2) gelegentlich auf die aktuelle Version und docker compose up -d; Navidrome migriert seine Datenbank beim Start. Der Rest läuft über deinen normalen Update-Prozess. Vor einem Versionssprung lohnt eine frische Sicherung der Datenbank – 0.64.0 hat zum Beispiel sämtliche internen IDs neu kodiert und dafür jede Tabelle angefasst; im Log steht danach Full scan required after migration, und der erste Start dauert länger als gewohnt. Aktuell halten lohnt sich trotzdem: Die 0.64er-Reihe hat mehrere gemeldete Sicherheitslücken geschlossen.

  • Datenbank sichern (eingebaut). Mit den ND_BACKUP_*-Variablen aus Schritt 3 legt Navidrome die Sicherung selbst an. Eine Sicherung sofort erzeugen:

    Terminal
    docker compose exec navidrome /app/navidrome backup create
    Ausgabe
    time="2026-09-30T23:45:06Z" level=info msg="Backup complete" elapsed=10.9ms path=/data/backup/navidrome_backup_2026.09.30_23.45.06.db

    Die Dateien liegen danach in /opt/navidrome/data/backup und sind bei einer kleinen Sammlung rund 700 KB groß. Zum Zurückspielen gibt es navidrome backup restore, zum Aufräumen alter Stände navidrome backup prune.

  • Backup zweigeteilt. Deine Musik ist der wertvolle, unwiederbringliche Teil – sie gehört ohnehin in dein Restic-Backup (oder du hast sie an anderer Stelle). Der data-Ordner mit Index, Abspielstatistiken, Playlists und Nutzerkonten ist klein und sollte mitgesichert werden; nimm dafür die Backup-Dateien aus dem vorigen Punkt statt der laufenden navidrome.db – eine im Betrieb weggesicherte SQLite-Datei kann inkonsistent sein.

  • Datenbank prüfen. Wenn die Oberfläche merkwürdige Fehler zeigt, sagt dir ein eingebauter Check, ob die Datenbank noch heil ist:

    Terminal
    docker compose exec navidrome /app/navidrome doctor
    Ausgabe
    Checking database integrity...
    Integrity check passed.
    Checking foreign keys...
    Foreign key check passed.
    Database is healthy.
  • Aufwand ist gering. Nach der Einrichtung besteht die Pflege vor allem darin, neue Musik in den Ordner zu legen – den Rest erledigt der stündliche Scan. Achte bei wachsender Sammlung auf den Speicherplatz (df -h); Musik summiert sich schnell auf. Der Dienst selbst bleibt klein: 48 MiB RAM im Betrieb, und das Image bringt mit rund 348 MB vor allem das mitgelieferte ffmpeg mit.

Feedback per E-Mail: feedback@serverkueche.de

Das könnte dir auch schmecken