Dieses Community-Tutorial dokumentiert eine Möglichkeit, AzuraCast auf ZimaOS zu betreiben, indem eine modifizierte Docker-Compose-Konfiguration als benutzerdefinierte App importiert wird. Der ursprüngliche Beitrag vom Dezember 2025 wurde auf einem ZimaBoard mit ZimaOS 1.5.3 Plus getestet und war für die private Nutzung zu Hause über das lokale Netzwerk oder Tailscale gedacht.
Wichtig: Der Autor aktualisierte den Thread später am 5. Januar 2026 und erklärte, dass weitere Tests gezeigt hätten, dass diese Installationsmethode manchmal instabil war oder nicht funktionierte. Auch die automatische Webaktualisierung von AzuraCast bereitete mit dieser Einrichtung Probleme. Diese spätere Korrektur ist wichtiger als die ursprüngliche Aussage, dass die Konfiguration einwandfrei funktioniere.
Welche ZimaOS-Konfiguration im ursprünglichen Leitfaden verwendet wurde
Als Ausgangsumgebung diente ein ZimaBoard mit einem Intel Celeron N3450, 8 GB Arbeitsspeicher, Intel HD Graphics 500 und ZimaOS 1.5.3 Plus. Der Autor importierte über die Oberfläche für benutzerdefinierte Apps von ZimaOS eine angepasste AzuraCast-Compose-Definition.
Der Ablauf war:
- Das ZimaOS-Dashboard öffnen und Benutzerdefinierte App installieren auswählen.
- Importieren verwenden und die Docker-Compose-Definition übermitteln.
- Die erzeugten Einstellungen für Web und Updater vor der Installation überprüfen.
- Die Ports auf dem Host sowie die Volume-Pfade auf der ZimaOS-Seite anpassen, ohne die entsprechenden AzuraCast-Containerpfade zu ändern.
- Die App installieren und AzuraCast über die Serveradresse und den konfigurierten Web-UI-Port öffnen.
Die aktuelle ZimaOS-Dokumentation unterstützt weiterhin den Import von Docker-Compose-YAML für benutzerdefinierte Apps. Siehe die aktuelle ZimaOS-Funktionsdokumentation.
Host-Ports zuordnen, ohne die Container-Ports zu ändern
In der Ausgangskonfiguration hob der Autor die Host-Zuordnungen hervor, die den AzuraCast-Container-Ports 80, 443 und 8000 entsprechen. Es wurde empfohlen, die Werte auf der Host-Seite an Ports anzupassen, die zur lokalen ZimaOS-Installation passen, und die Werte auf der Container-Seite unverändert zu lassen.
Der Updater-Reiter enthielt ebenfalls die Web-UI-Adresse. Dem Leitfaden zufolge sollte dieser Web-UI-Port mit dem Host-Port übereinstimmen, der dem Container-Port 80 zugeordnet ist.
AzuraCast-Containerpfade unverändert lassen
Der Autor ordnete außerdem den persistenten Speicher auf der ZimaOS-Seite neu zu, während die AzuraCast-seitigen Pfade unverändert blieben. Der veröffentlichte Stack enthielt Speicher für Sender, Backups, MySQL-Daten, Uploads, optionale Komponenten und ein separates Musikverzeichnis.
Der Leitfaden riet davon ab, Umgebungsvariablen zu ändern, sofern der Administrator deren Zweck nicht versteht. Das ist besonders wichtig, da Anmeldedaten für Anwendungen und Datenbankeinstellungen in Compose-Umgebungsdaten enthalten sein können.
Die veröffentlichte Compose-Datei nicht als wiederverwendbare Vorlage für Zugangsdaten behandeln
Die ursprüngliche YAML-Datei aus dem Forum enthält umgebungsbezogene Werte für die Datenbank. Eine Community-Seite sollte diese veröffentlichten Werte nicht in eine wiederverwendbare Vorlage für Zugangsdaten verwandeln. Wenn du diesen Stack neu aufsetzt, verwende Zugangsdaten, die für deine eigene Installation geeignet sind, und beachte die aktuellen Konfigurationshinweise von AzuraCast.
Aktuelle Informationen zur Installation und Konfiguration findest du in der offiziellen Docker-Installationsanleitung von AzuraCast.
Der Autor meldete später Stabilitäts- und Aktualisierungsprobleme
Neun Tage nach der Veröffentlichung des Leitfadens veröffentlichte derselbe Autor eine wichtige Korrektur: Weitere Experimente hätten gezeigt, dass diese Methode manchmal nicht funktionierte und instabil sein konnte. Außerdem berichtete der Autor über Probleme mit dem automatischen Webaktualisierungsprozess von AzuraCast bei dieser Installationsmethode.
Der Autor erklärte, dass er mit einer SSH-basierten Installation experimentiere und einen ausführlicheren Folgebeitrag plane. In diesem Thread wurde jedoch kein Ersatzverfahren veröffentlicht. Daher sollte diese Seite als dokumentiertes Community-Experiment mit bekannten Einschränkungen gelesen werden, nicht als aktuell offiziell unterstützte Installationsmethode für AzuraCast auf ZimaOS.
Die Community-Methode mit den aktuellen AzuraCast-Empfehlungen vergleichen
Die aktuelle AzuraCast-Dokumentation empfiehlt Docker für die meisten selbst gehosteten Installationen und stellt einen eigenen Installations- und Aktualisierungsablauf für Docker bereit. Außerdem werden Benutzer aufgefordert, vor Aktualisierungen Backups zu erstellen, da bei einem fehlgeschlagenen Update Ausfallzeiten des Senders oder Datenverlust möglich sind.
Lies die offizielle AzuraCast-Dokumentation zu Aktualisierungen, bevor du dich auf das Verhalten des Updaters aus diesem historischen ZimaOS-Compose-Stack verlässt.
Der Ausgangsleitfaden war für die private Netzwerknutzung gedacht
Der Autor stellte das Tutorial ausdrücklich für den Zugriff zu Hause oder in einem privaten Netzwerk über das lokale Netzwerk oder Tailscale vor. Die Veröffentlichung eines Dienstes im öffentlichen Internet kann zusätzliche Entscheidungen zu Netzwerk, TLS, Firewall, Authentifizierung und Übertragungssicherheit erfordern, die nicht Gegenstand des Community-Beitrags waren.
Gehe nicht davon aus, dass eine funktionierende lokale Web-UI allein eine ausreichende Vorbereitung für einen öffentlichen Radiosender darstellt.
FAQ: AzuraCast auf ZimaOS
Hat der Community-Autor bestätigt, dass diese Methode stabil ist?
Nein. Der ursprüngliche Beitrag war optimistisch, aber im Follow-up vom 5. Januar 2026 wurde ausdrücklich erklärt, dass die Methode in einigen Tests instabil sein oder fehlschlagen konnte.
Welche ZimaOS-Version wurde verwendet?
Im ursprünglichen Leitfaden wurde ZimaOS 1.5.3 Plus auf einem ZimaBoard verwendet. Betrachte die Screenshots und die erzeugten App-Einstellungen als historische Beispiele und nicht als genaue Anleitung für jede neuere Version.
Sollte ich die Volume-Pfade auf der AzuraCast-Containerseite ändern?
Der Ausgangsleitfaden empfiehlt, die ZimaOS-Hostpfade nach Bedarf zu ändern und die AzuraCast-Containerpfade unverändert zu lassen.
Warum muss der Web-UI-Port des Updaters mit der Webdienst-Zuordnung übereinstimmen?
In der Ausgangskonfiguration verwies der Web-UI-Eintrag des Updaters auf den Host-Port, der dem Container-Port 80 zugeordnet war. Ein anderer Wert würde die ZimaOS-Verknüpfung an den falschen Port senden.
Funktioniert die automatische Aktualisierung von AzuraCast mit diesem Community-Stack zuverlässig?
Der Autor berichtete nach weiteren Tests ausdrücklich über Probleme mit der automatischen Webaktualisierung. Verwende die aktuelle AzuraCast-Dokumentation zu Aktualisierungen und erstelle Backups, anstatt davon auszugehen, dass der historische Updater-Container zuverlässig ist.
