Den här communityguiden beskriver ett sätt att köra AzuraCast på ZimaOS genom att importera en modifierad Docker Compose-konfiguration som en anpassad app. Det ursprungliga inlägget från december 2025 testades på en ZimaBoard med ZimaOS 1.5.3 Plus och fokuserade på privat användning eller hemmabruk via det lokala nätverket eller Tailscale.
Viktigt: författaren uppdaterade senare tråden den 5 januari 2026 och uppgav att ytterligare tester visade att installationsmetoden ibland var instabil eller inte fungerade, samt att AzuraCasts automatiska webbuppdatering också hade problem med konfigurationen. Den senare rättelsen är viktigare än det ursprungliga påståendet att konfigurationen fungerade perfekt.
Vad den ursprungliga ZimaOS-konfigurationen använde
Källmiljön var en ZimaBoard med en Intel Celeron N3450, 8 GB minne, Intel HD Graphics 500 och ZimaOS 1.5.3 Plus. Författaren importerade en anpassad AzuraCast Compose-definition via ZimaOS gränssnitt för anpassade appar.
Arbetsflödet var:
- Öppna ZimaOS kontrollpanel och välj Installera en anpassad app.
- Använd Importera och skicka in Docker Compose-definitionen.
- Granska de genererade inställningarna för web och updater före installationen.
- Justera värdportarna och volymsökvägarna på ZimaOS-sidan utan att ändra motsvarande sökvägar i AzuraCast-containern.
- Installera appen och öppna AzuraCast med serveradressen och den konfigurerade porten för webbgränssnittet.
Den aktuella ZimaOS-dokumentationen stöder fortfarande import av Docker Compose-YAML för anpassade appar. Se den aktuella ZimaOS-dokumentationen om funktioner.
Mappa värdportar utan att ändra containerportarna
I källkonfigurationen markerade författaren värdmappningarna som motsvarade AzuraCast-containerportarna 80, 443 och 8000. Rekommendationen var att ändra värdsidans värden till portar som passar den lokala ZimaOS-installationen, samtidigt som värdena på containersidan lämnas oförändrade.
Fliken för uppdateraren innehöll också adressen till webbgränssnittet. Enligt guiden ska denna port för webbgränssnittet matcha värdporten som mappats till containerport 80.
Behåll AzuraCast-containerns sökvägar oförändrade
Författaren mappade även om beständig lagring på ZimaOS-sidan, samtidigt som sökvägarna på AzuraCast-sidan lämnades oförändrade. Stacken som publicerades innehöll lagring för stationer, säkerhetskopior, MySQL-data, uppladdningar, valfria komponenter och en separat musikkatalog.
Guiden avrådde från att ändra miljövariabler om administratören inte förstod deras syfte. Det är särskilt viktigt eftersom inloggningsuppgifter och databasinställningar kan finnas i Compose-miljödata.
Betrakta inte den publicerade Compose-filen som en återanvändbar mall för hemligheter
Det ursprungliga YAML-inlägget på forumet innehåller miljövärden relaterade till databasen. En communitysida bör inte omvandla de publicerade värdena till en återanvändbar mall för inloggningsuppgifter. Om du bygger om denna stack ska du använda inloggningsuppgifter som passar din egen installation och följa aktuell konfigurationsvägledning för AzuraCast.
För aktuell information om installation och konfiguration uppströms använder du den officiella installationsguiden för AzuraCast med Docker.
Författaren rapporterade senare problem med stabilitet och uppdateringar
Nio dagar efter att guiden publicerades lade samma författare upp en viktig rättelse: ytterligare experiment visade att metoden ibland inte fungerade och kunde vara instabil. Författaren rapporterade även problem med AzuraCasts automatiska webbaserade uppdateringsprocess med denna installationsmetod.
Författaren uppgav att de experimenterade med en SSH-baserad installation och planerade en mer detaljerad uppföljningsguide, men ingen ersättande procedur publicerades i denna tråd. Därför bör denna sida läsas som ett dokumenterat communityexperiment med kända begränsningar, inte som en aktuell officiellt stödd installationsmetod för AzuraCast på ZimaOS.
Jämför communitymetoden med aktuell vägledning för AzuraCast
Den aktuella dokumentationen för AzuraCast rekommenderar Docker för de flesta självhostade installationer och har ett eget arbetsflöde för Docker-installationer och uppdateringar. Den varnar också användare för att säkerhetskopiera före uppdateringar, eftersom driftstopp för stationen eller dataförlust kan inträffa om en uppdatering misslyckas.
Se den officiella dokumentationen om AzuraCast-uppdateringar innan du förlitar dig på uppdaterarfunktionen i denna historiska ZimaOS Compose-stack.
Källguiden var avsedd för privat nätverksanvändning
Författaren beskrev uttryckligen handledningen som avsedd för åtkomst i hemmet eller privat åtkomst via det lokala nätverket eller Tailscale. Exponering mot det offentliga internet kan kräva ytterligare beslut om nätverk, TLS, brandvägg, autentisering och sändningssäkerhet, vilket låg utanför communityinläggets omfattning.
Anta inte att ett fungerande lokalt webbgränssnitt är tillräcklig förberedelse för en offentlig radiotjänst.
Vanliga frågor om AzuraCast på ZimaOS
Bekräftade communityförfattaren att denna metod är stabil?
Nej. Det ursprungliga inlägget var optimistiskt, men uppföljningen den 5 januari 2026 sade uttryckligen att metoden kunde vara instabil eller misslyckas i vissa tester.
Vilken version av ZimaOS användes?
Den ursprungliga guiden använde ZimaOS 1.5.3 Plus på en ZimaBoard. Betrakta skärmbilderna och de genererade appinställningarna som historiska exempel snarare än exakta instruktioner för alla nyare versioner.
Bör jag ändra volymsökvägarna på AzuraCast-containersidan?
Källguiden säger att sökvägarna på ZimaOS-värdsidan ska ändras efter behov, medan sökvägarna på AzuraCast-containersidan ska lämnas oförändrade.
Varför måste uppdaterarens port för webbgränssnittet matcha webbtjänstens mappning?
I källkonfigurationen pekade uppdaterarens post för webbgränssnittet på värdporten som mappats till containerport 80. Om ett annat värde används kommer ZimaOS-genvägen att skicka dig till fel port.
Fungerar AzuraCasts automatiska uppdatering tillförlitligt med denna communitystack?
Författaren rapporterade specifikt problem med den automatiska webbaserade uppdateringen efter ytterligare tester. Använd aktuell dokumentation om AzuraCast-uppdateringar och se till att ha säkerhetskopior i stället för att anta att den historiska uppdaterarcontainern är tillförlitlig.
