Questo tutorial della community documenta un metodo per eseguire AzuraCast su ZimaOS importando una configurazione Docker Compose modificata come app personalizzata. Il post originale di dicembre 2025 era stato testato su uno ZimaBoard con ZimaOS 1.5.3 Plus e si concentrava sull'uso privato o domestico tramite rete locale o Tailscale.
Importante: l'autore ha successivamente aggiornato la discussione il 5 gennaio 2026, affermando che ulteriori test avevano mostrato che questo metodo di installazione era talvolta instabile o non funzionava e che anche l'aggiornamento web automatico di AzuraCast presentava problemi con questa configurazione. Questa correzione successiva è più importante dell'affermazione originale secondo cui la configurazione funzionava perfettamente.
Configurazione ZimaOS originale utilizzata
L'ambiente di partenza era uno ZimaBoard con Intel Celeron N3450, 8 GB di memoria, Intel HD Graphics 500 e ZimaOS 1.5.3 Plus. L'autore ha importato una definizione Compose personalizzata di AzuraCast tramite l'interfaccia delle app personalizzate di ZimaOS.
La procedura era:
- Aprire il pannello di ZimaOS e scegliere Installa un'app personalizzata.
- Usare Importa e inviare la definizione Docker Compose.
- Controllare le impostazioni web e updater generate prima dell'installazione.
- Modificare le porte sul lato host e i percorsi dei volumi sul lato ZimaOS senza cambiare i corrispondenti percorsi dei container AzuraCast.
- Installare l'app e aprire AzuraCast usando l'indirizzo del server e la porta dell'interfaccia web configurata.
La documentazione attuale di ZimaOS continua a supportare l'importazione di YAML Docker Compose per le app personalizzate. Consulta la documentazione attuale sulle funzionalità di ZimaOS.
Mappa le porte host senza modificare quelle dei container
Nella configurazione originale, l'autore ha evidenziato le associazioni sul lato host corrispondenti alle porte dei container AzuraCast 80, 443 e 8000. La raccomandazione era modificare i valori sul lato host in base alle esigenze dell'installazione locale di ZimaOS, lasciando invariati i valori sul lato container.
Anche la scheda updater conteneva l'indirizzo dell'interfaccia web. La guida indica che questa porta dell'interfaccia web deve corrispondere alla porta sul lato host associata alla porta 80 del container.
Mantieni stabili i percorsi dei container AzuraCast
L'autore ha inoltre rimappato lo spazio di archiviazione persistente sul lato ZimaOS, lasciando invariati i percorsi sul lato AzuraCast. Lo stack pubblicato includeva spazio per le stazioni, i backup, i dati MySQL, i caricamenti, i componenti opzionali e una directory musicale separata.
La guida sconsigliava di modificare le variabili d'ambiente, a meno di conoscerne lo scopo. Questo è particolarmente importante perché le credenziali dell'applicazione e le impostazioni del database possono essere incluse nei dati d'ambiente di Compose.
Non trattare il file Compose pubblicato come un modello riutilizzabile di segreti
Il file YAML originale del forum contiene valori d'ambiente relativi al database. Una pagina della community non dovrebbe trasformare quei valori pubblicati in un modello riutilizzabile di credenziali. Se ricrei questo stack, usa credenziali adatte alla tua installazione e segui le indicazioni di configurazione aggiornate di AzuraCast.
Per informazioni aggiornate sull'installazione e sulla configurazione ufficiali, usa la guida ufficiale all'installazione Docker di AzuraCast.
L'autore ha successivamente segnalato problemi di stabilità e aggiornamento
Nove giorni dopo aver pubblicato la guida, lo stesso autore ha pubblicato un'importante correzione: ulteriori esperimenti avevano mostrato che questo metodo talvolta non funzionava e poteva essere instabile. L'autore ha inoltre segnalato problemi con il processo di aggiornamento web automatico di AzuraCast utilizzando questo metodo di installazione.
L'autore ha dichiarato di stare sperimentando un'installazione basata su SSH e di voler preparare una guida di approfondimento, ma in questa discussione non è stata pubblicata alcuna procedura sostitutiva. Per questo motivo, questa pagina dovrebbe essere letta come un esperimento documentato della community con limitazioni note, non come un metodo di installazione attuale e ufficialmente supportato per AzuraCast su ZimaOS.
Confronta il metodo della community con le indicazioni attuali di AzuraCast
La documentazione attuale di AzuraCast consiglia Docker per la maggior parte delle installazioni self-hosted e mantiene una propria procedura di installazione e aggiornamento tramite Docker. Avverte inoltre gli utenti di eseguire un backup prima degli aggiornamenti, perché in caso di errore possono verificarsi interruzioni del servizio o perdite di dati.
Consulta la documentazione ufficiale sugli aggiornamenti di AzuraCast prima di fare affidamento sul comportamento dell'updater di questo stack Compose storico per ZimaOS.
La guida originale era destinata all'uso su una rete privata
L'autore ha esplicitamente concepito il tutorial per l'accesso domestico o privato tramite rete locale o Tailscale. L'esposizione a Internet pubblico può richiedere ulteriori decisioni relative a rete, TLS, firewall, autenticazione e sicurezza della trasmissione, che non rientravano nell'ambito del post della community.
Non dare per scontato che un'interfaccia web funzionante sulla rete locale sia una preparazione sufficiente per un servizio radio pubblico.
Domande frequenti su AzuraCast su ZimaOS
L'autore della community ha confermato che questo metodo è stabile?
No. Il post originale era ottimista, ma il seguito del 5 gennaio 2026 affermava esplicitamente che il metodo poteva essere instabile o non funzionare in alcuni test.
Quale versione di ZimaOS è stata utilizzata?
La guida originale utilizzava ZimaOS 1.5.3 Plus su uno ZimaBoard. Considera le schermate e le impostazioni dell'app generate come esempi storici, non come istruzioni esatte per ogni versione più recente.
Devo modificare i percorsi dei volumi sul lato container di AzuraCast?
La guida originale indica di modificare, secondo necessità, i percorsi sul lato host di ZimaOS, lasciando invariati quelli sul lato container di AzuraCast.
Perché la porta dell'interfaccia web dell'updater deve corrispondere all'associazione del servizio web?
Nella configurazione originale, la voce dell'interfaccia web dell'updater indicava la porta host associata alla porta 80 del container. L'utilizzo di un valore diverso indirizzerebbe il collegamento rapido di ZimaOS alla porta sbagliata.
L'aggiornamento automatico di AzuraCast funziona in modo affidabile con questo stack della community?
L'autore ha segnalato specificamente problemi con l'aggiornamento web automatico dopo ulteriori test. Usa la documentazione attuale di AzuraCast sugli aggiornamenti ed esegui backup regolari, invece di presumere che il container updater storico sia affidabile.
