Deze communitytutorial beschrijft een manier om AzuraCast op ZimaOS uit te voeren door een aangepaste Docker Compose-configuratie als een aangepaste app te importeren. De oorspronkelijke post uit december 2025 is getest op een ZimaBoard met ZimaOS 1.5.3 Plus en was gericht op privé- of thuisgebruik via het lokale netwerk of Tailscale.
Belangrijk: de auteur heeft de discussie later, op 5 januari 2026, bijgewerkt en aangegeven dat uit verdere tests bleek dat deze installatiemethode soms instabiel was of niet werkte. Ook de automatische webupdates van AzuraCast leverden problemen op met deze configuratie. Deze latere correctie is belangrijker dan de oorspronkelijke bewering dat de configuratie perfect werkte.
Wat de oorspronkelijke ZimaOS-installatie gebruikte
De bronomgeving was een ZimaBoard met een Intel Celeron N3450, 8 GB geheugen, Intel HD Graphics 500 en ZimaOS 1.5.3 Plus. De auteur importeerde een aangepaste AzuraCast Compose-definitie via de interface voor aangepaste apps van ZimaOS.
De werkwijze was:
- Open het ZimaOS-dashboard en kies Een aangepaste app installeren.
- Gebruik Importeren en dien de Docker Compose-definitie in.
- Controleer de gegenereerde instellingen voor web en updater vóór de installatie.
- Pas de poorten aan de hostzijde en de volumepaden aan de ZimaOS-zijde aan, zonder de bijbehorende AzuraCast-containerpaden te wijzigen.
- Installeer de app en open AzuraCast met het serveradres en de geconfigureerde Web UI-poort.
De huidige ZimaOS-documentatie ondersteunt nog steeds het importeren van Docker Compose YAML voor aangepaste apps. Bekijk de actuele documentatie over ZimaOS-functies.
Wijs hostpoorten toe zonder de containerpoorten te wijzigen
In de bronconfiguratie markeerde de auteur de hosttoewijzingen voor de AzuraCast-containerpoorten 80, 443 en 8000. Het advies was om de waarden aan de hostzijde te wijzigen naar poorten die passen bij de lokale ZimaOS-installatie, en de waarden aan de containerzijde ongewijzigd te laten.
Het tabblad voor de updater bevatte ook het Web UI-adres. Volgens de gids moet deze Web UI-poort overeenkomen met de hostpoort die aan containerpoort 80 is toegewezen.
Houd de containerpaden van AzuraCast ongewijzigd
De auteur wees ook permanente opslag opnieuw toe aan de ZimaOS-zijde, terwijl de paden aan de AzuraCast-zijde ongewijzigd bleven. De gepubliceerde stack bevatte opslag voor stations, back-ups, MySQL-gegevens, uploads, optionele componenten en een afzonderlijke muziekmap.
De gids raadde af om omgevingsvariabelen te wijzigen tenzij de beheerder het doel ervan begreep. Dat is vooral belangrijk omdat in Compose-omgevingsgegevens inloggegevens voor applicaties en database-instellingen kunnen staan.
Gebruik het gepubliceerde Compose-bestand niet als herbruikbaar sjabloon voor geheimen
De oorspronkelijke YAML op het forum bevat omgevingswaarden die met de database te maken hebben. Een communitypagina mag deze gepubliceerde waarden niet omzetten in een herbruikbaar sjabloon voor inloggegevens. Gebruik bij het opnieuw opbouwen van deze stack inloggegevens die bij je eigen installatie passen en volg de actuele configuratierichtlijnen van AzuraCast.
Gebruik voor actuele informatie over de installatie en configuratie van de upstreamversie de officiële Docker-installatiehandleiding van AzuraCast.
De auteur meldde later stabiliteits- en updateproblemen
Negen dagen na de publicatie van de gids plaatste dezelfde auteur een belangrijke correctie: uit aanvullende experimenten bleek dat deze methode soms niet werkte en instabiel kon zijn. De auteur meldde ook problemen met het automatische webupdateproces van AzuraCast bij deze installatiemethode.
De auteur gaf aan te experimenteren met een installatie via SSH en een uitgebreidere vervolggids te willen publiceren, maar in deze discussie is geen vervangende procedure gepubliceerd. Daarom moet deze pagina worden gelezen als een gedocumenteerd communityexperiment met bekende beperkingen, en niet als een actuele, officieel ondersteunde methode om AzuraCast op ZimaOS te installeren.
Vergelijk de communitymethode met de actuele richtlijnen van AzuraCast
De huidige AzuraCast-documentatie raadt Docker aan voor de meeste zelfgehoste installaties en onderhoudt een eigen installatie- en updateproces voor Docker. Gebruikers wordt ook aangeraden vóór updates een back-up te maken, omdat een mislukte update tot uitval van stations of gegevensverlies kan leiden.
Bekijk de officiële update-documentatie van AzuraCast voordat je vertrouwt op het gedrag van de updater in deze historische ZimaOS Compose-stack.
De bronhandleiding was bedoeld voor gebruik op een privénetwerk
De auteur presenteerde de tutorial uitdrukkelijk voor thuisgebruik of privétoegang via het lokale netwerk of Tailscale. Voor blootstelling aan het openbare internet kunnen aanvullende keuzes nodig zijn op het gebied van netwerken, TLS, firewalls, authenticatie en uitzendbeveiliging; die vielen buiten het bereik van de communitypost.
Ga er niet van uit dat een lokaal werkende Web UI voldoende voorbereiding is voor een openbare radioservice.
Veelgestelde vragen over AzuraCast op ZimaOS
Heeft de communityauteur bevestigd dat deze methode stabiel is?
Nee. De oorspronkelijke post was optimistisch, maar in de vervolgbijdrage van 5 januari 2026 stond uitdrukkelijk dat de methode in sommige tests instabiel kon zijn of kon mislukken.
Welke ZimaOS-versie werd gebruikt?
De oorspronkelijke gids gebruikte ZimaOS 1.5.3 Plus op een ZimaBoard. Beschouw de schermafbeeldingen en gegenereerde app-instellingen als historische voorbeelden, niet als exacte instructies voor elke nieuwere release.
Moet ik de volumepaden aan de AzuraCast-containerzijde wijzigen?
Volgens de bronhandleiding moeten de paden aan de ZimaOS-hostzijde indien nodig worden gewijzigd, terwijl de paden aan de AzuraCast-containerzijde ongewijzigd blijven.
Waarom moet de Web UI-poort van de updater overeenkomen met de toewijzing van de webservice?
In de bronconfiguratie verwees de Web UI-vermelding van de updater naar de hostpoort die aan containerpoort 80 was toegewezen. Een andere waarde zou de ZimaOS-snelkoppeling naar de verkeerde poort sturen.
Werkt de automatische update van AzuraCast betrouwbaar met deze communitystack?
De auteur meldde na verdere tests specifiek problemen met automatische webupdates. Gebruik de actuele updatedocumentatie van AzuraCast en zorg voor back-ups in plaats van ervan uit te gaan dat de historische updatercontainer betrouwbaar is.
