Benutzer, Zugang und Sicherungen¶

5. Benutzer und Zugang¶

5.1 Benutzer auf der Befehlszeile¶

Auf der Seite legt ein Admin Benutzer an, löscht sie und setzt Passwörter (Benutzerhandbuch, Abschnitt 11). Auf der Box, als Benutzer der Box:

tinyjukebox-users -f /srv/tinyjukebox/ssl/users.yaml list
tinyjukebox-users -f /srv/tinyjukebox/ssl/users.yaml add NAME --role admin
tinyjukebox-users -f /srv/tinyjukebox/ssl/users.yaml passwd NAME
tinyjukebox-users -f /srv/tinyjukebox/ssl/users.yaml role NAME admin
tinyjukebox-users -f /srv/tinyjukebox/ssl/users.yaml remove NAME

Nur hier lässt sich eine Rolle ändern. Den letzten Admin löscht der Befehl nicht und macht ihn auch nicht zum user.
Eine Änderung wirkt sofort, ohne Neustart. Ein neues Passwort beendet die anderen Sitzungen dieses Benutzers.
Für eine Bibliothek auf einem PC ist die Datei ssl/users.yaml in ihrem Ordner. In Docker führt das Image den Befehl aus, mit dem Volume der Bibliothek: docker run --rm -v library:/data ghcr.io/tgd1975/tinyjukebox tinyjukebox-users -f /data/ssl/users.yaml list.
Das Paket auf dem NAS hat keinen Befehl tinyjukebox-users: Der Aufruf mit dem Python des Pakets steht in operations.md, Abschnitt 4.

5.2 Ein vergessenes Passwort¶

Ein anderer Admin setzt auf der Seite ein neues Passwort, Tab „System“, Abschnitt „Benutzer“.
Kennt kein Admin mehr sein Passwort: sich mit SSH auf der Box anmelden.
tinyjukebox-users -f /srv/tinyjukebox/ssl/users.yaml passwd admin – fragt zweimal nach dem neuen Passwort.
Damit auf der Seite anmelden.

5.3 SSH¶

Erreichbar ist die Box mit ssh <Benutzer>@<Hostname>.local, so wie der Imager sie eingerichtet hat. Wird der Name nicht gefunden, hilft die Adresse der Box im Router. Eine neu geschriebene Karte hat einen neuen Schlüssel: Kennt der PC noch den alten, verweigert SSH die Verbindung, bis der alte Eintrag mit ssh-keygen -R <Hostname>.local entfernt ist.

5.4 Das Zertifikat der Seite¶

Box und Bibliothek erzeugen ihr eigenes Zertifikat, bei ihrem ersten Start. Beim ersten Mal warnt der Browser davor.

Den Fingerabdruck, den der Browser zeigt, mit dem im Log vergleichen: Die Box schreibt ihn, wenn die Seite startet (rest api listening on … fingerprint), die Bibliothek ebenfalls in ihr Log.
Oder das Zertifikat der Box als vertrauenswürdig importieren: /srv/tinyjukebox/ssl/tinyjukebox.crt.
Die Befehle auf dem PC, tinyjukebox-backup und tinyjukebox-fill-library, zeigen den Fingerabdruck ebenfalls und fragen, bevor sie weitermachen.

6. Daten und Sicherungen¶

6.1 Was ein Backup enthält¶

Ein Backup ist eine Datei mit den Daten einer Box oder der Bibliothek, erstellt im laufenden Betrieb:

eine Box: Tags, Alben, Sender und Spotify-Einträge, Fortschritte, Lautstärkegrenzen und die Titelbilder
die Bibliothek: der Katalog, Fortschritte und Einstellungen jeder Box, die Statistik, die Zustände der Versionen und die Titelbilder
mit „MP3s“ auch die Alben – die Datei ist dann so groß wie alle Alben zusammen

Eine Box mit Bibliothek braucht kein eigenes Backup: Die Bibliothek hat alles, und eine neu eingerichtete Box holt es sich von dort.

6.2 Backups erstellen¶

Weg	Box	Bibliothek
Seite, Tab „System“, Karte „Backup“	„Backup herunterladen“, „Backup mit MP3s herunterladen“	ebenso
Seite, „Regelmäßig sichern“	eine Box ohne Bibliothek, nach `/srv/tinyjukebox/backups`	in den freigegebenen Ordner `tinyjukebox` auf dem NAS, den Hyper Backup mitsichert
Befehl auf dem PC	`tinyjukebox-backup https://tinyjukebox.local --user admin [--albums] [ORDNER]`	`tinyjukebox-backup https://<nas>:8866 --user admin [--albums] [ORDNER]`

Zwei Zeitpläne, einer ohne und einer mit den Alben, jeder mit seinem Ordner und der Zahl der Backups, die bleiben: Benutzerhandbuch, Abschnitt 11.2. Die Backups einer Box liegen auf ihrer SD-Karte: Gegen eine kaputte Karte hilft nur ein Backup, das man von ihr geholt hat.

6.3 Ein Backup zurückspielen¶

Auf der Seite, Tab „System“, Karte „Backup“, „Backup zurückspielen“ – oder tinyjukebox-backup … --restore DATEI auf dem PC. Die Seite fragt einmal nach, dann startet die Box oder die Bibliothek mit den Daten des Backups neu (Benutzerhandbuch, Abschnitt 11.3).

Ein Backup ohne die Alben lässt den Ordner der Alben in Ruhe. Alben, die in den Daten stehen, deren Ordner aber fehlt, werden nach dem Zurückspielen aufgelistet.
Auf einer Box mit Bibliothek gewinnt bei der nächsten Synchronisation die Bibliothek. Zurückspielen ist für eine Box ohne Bibliothek und für die Bibliothek gedacht.
Die Bibliothek auf einem anderen NAS, oder von Hand ohne das Programm: operations.md, Abschnitt 10.3.

6.4 Was in keinem Backup ist¶

Benutzer, Passwörter, das Zertifikat, Tokens – in der Bibliothek auch settings.json mit dem Bootstrap-Passwort
der Schlüssel der Box und ihre Verbindung zur Bibliothek
Schlüssel, Player und Anmeldung von Spotify: Der Schlüssel wird neu eingefügt, die Box holt den Player neu und wird neu verbunden („Verbinden“)
die Konfigurationsdatei