Erste Schritte

Willkommen bei Tunetorch! Diese Seite führt dich vom ersten Start bis zur laufenden Instanz und zeigt dir, wo in dieser Dokumentation was steht.

Was Tunetorch ist

Tunetorch ist eine selbstgehostete Musik-Streaming-Plattform. Der Server läuft als Docker-Container auf deiner eigenen Hardware, etwa auf einem Raspberry Pi, einem NAS oder einem kleinen Heimserver. Deine Musik und alle Daten dazu bleiben dort. Tunetorch sammelt keine Telemetrie, zeigt keine Werbung und braucht keine Cloud.

Hören kannst du im Browser, in der installierbaren PWA, in der Android-App oder über einen DLNA-Lautsprecher im Heimnetz.

Was du brauchst


Hardware	Ein Gerät, das dauerhaft läuft. Ein Raspberry Pi 4/5 reicht auch für große Sammlungen.
Docker	Docker Engine, am besten mit Docker Compose. FFmpeg, Datenbank und Cache bringt das Image selbst mit.
Speicherplatz	Deine Musik plus etwas Reserve für Cover, konvertierte Fassungen und die Datenbank.
Musik	Deine eigenen Dateien: MP3, FLAC, AAC/M4A, OGG, Opus, WAV, AIFF, WMA.

Optional, aber empfohlen ist ein Reverse-Proxy mit HTTPS. Für die installierbare PWA brauchst du ihn sogar, weil Service Worker nur über HTTPS laufen.

In vier Schritten startklar

Installieren: Container mit einer docker-compose.yml starten. → Installation mit Docker
Anmelden: Weboberfläche öffnen, mit dem Standard-Admin anmelden und das Passwort ändern. Tunetorch verlangt diesen Wechsel beim ersten Login.
Musik hineinbringen: hochladen, eine bestehende Sammlung importieren oder einen Ordner einhängen und scannen lassen. → Bibliothek befüllen
Einrichten: Zeitzone setzen, Wartungs-Tasks aktivieren, weitere Konten anlegen. → Konfiguration · Benutzer & Rechte

Der erste Login

Nach dem Start erreichst du die Oberfläche unter http://<server-adresse>:5000.

Rufst du Tunetorch ohne TLS auf? Dann müssen in der docker-compose.yml TT_HTTPS: "False" und TT_TRUSTED_PROXIES: "0" stehen. Sonst nimmt der Server die Anmeldung zwar an, der Browser verwirft aber die Cookies, und du landest wieder auf der Anmeldeseite. Der Schnellstart enthält beide Zeilen schon.

Beim ersten Start legt Tunetorch ein Admin-Konto an:

Benutzername	Passwort
`admin`	`BITTE_ÄNDERE_MICH`

Du musst das Passwort ändern. Solange das voreingestellte Passwort gesetzt ist (und das kennt jeder, der diese Seite gelesen hat), sperrt ein Hinweis die ganze App. Erst mit einem eigenen Passwort geht es weiter. Das Standard-Passwort lässt sich danach nicht wieder setzen.

Danach lohnen sich drei Handgriffe in den Server-Einstellungen:

Zeitzone prüfen (Standard ist Europe/Berlin). Sie bestimmt die Zeitstempel im Log, die Datumsangaben und die Uhrzeiten der Wartungs-Tasks.
Sprache der Server-Logs wählen. Ab Werk schreibt der Server sein Log auf Deutsch, auf Englisch stellst du es hier um. Jede Zeile beginnt mit einem Code wie [TT-DLNA-012], der in beiden Sprachen gleich ist.
Wartung & Cron-Tasks durchsehen. Der Datei-Scan ist ab Werk aus. Du brauchst ihn nur, wenn du einen Musikordner eingehängt hast.

Wie diese Dokumentation aufgebaut ist

Kapitel	Worum es geht
Einstieg	Diese Seite und der Funktionsüberblick.
Installation	Docker, Konfiguration und das Befüllen der Bibliothek.
Benutzung	Alles, was du als Hörer und Sammler im Alltag tust, von der Oberfläche bis zum Export.
Verwaltung	Benutzer & Rechte, Server verwalten, Sicherheit & Datensicherung.
Abo	Das optionale Tunetorch Pro.
Hilfe	Häufige Fragen und die Fehlerbehebung.

Oben links durchsuchst du die gesamte Dokumentation, rechts steht das Inhaltsverzeichnis der aktuellen Seite.

Weiter geht's

Funktionsüberblick: was Tunetorch alles kann
Installation mit Docker: der praktische Teil