it-know-how/privat/Navidrome Rescan.md

Navidrome

🧩 Option 1: Über die Web-Oberfläche

Wenn du nur die Bibliothek neu scannen willst:

1. Melde dich als Admin in der Weboberfläche an.

2. Gehe zu Settings → Admin → Rescan Library (oder „Bibliothek neu scannen“).

3. Wähle „Full Rescan“ (Vollständiger Scan) aus.

Das ist der einfachste Weg — aber wenn du den Vorgang per Shell oder Skript auslösen willst, siehe Option 2 oder 3.

---

🐳 Option 2: Über die Docker Shell

Wenn du direkten Zugriff auf den Container hast:

docker exec -it <container_name> navidrome rescan --force

🔹 <container_name> ersetzt du durch den tatsächlichen Namen deines Containers, z. B. navidrome.
🔹 Der Parameter --force erzwingt eine vollständige Neuindizierung (nicht nur eine inkrementelle).

Beispiel:

docker exec -it navidrome navidrome rescan --force

Falls navidrome nicht im PATH ist (z. B. je nach Image):

docker exec -it navidrome /app/navidrome rescan --force

---

⚙️ Option 3: Durch Neustart mit Umgebungsvariable

Wenn du den Container neu startest und gleich beim Start eine Neuindizierung erzwingen willst, kannst du temporär folgende Umgebungsvariable setzen:

docker run -d \
  -e ND_SCAN_ON_STARTUP=true \
  -e ND_SCAN_FORCED=true \
  ...
  --name navidrome \
  deluan/navidrome:latest

Oder, wenn du docker-compose nutzt:

environment:
  - ND_SCAN_ON_STARTUP=true
  - ND_SCAN_FORCED=true

Dann einmal:

docker compose restart navidrome

Das löst bei jedem Start eine vollständige Neuindizierung aus.

---

🧠 Zusatzinfos

• navidrome rescan akzeptiert auch --quiet (ohne Logausgabe).

• Der Fortschritt erscheint in den Logs:

  docker logs -f navidrome
  

• Die Indizierung kann bei großen Bibliotheken einige Zeit dauern.