Ce tutoriel communautaire décrit une méthode pour exécuter AzuraCast sur ZimaOS en important une configuration Docker Compose modifiée sous forme d’application personnalisée. La publication originale de décembre 2025 a été testée sur un ZimaBoard équipé de ZimaOS 1.5.3 Plus et concernait principalement un usage privé ou domestique sur le réseau local ou via Tailscale.
Important : l’auteur a ensuite mis à jour le fil le 5 janvier 2026 et indiqué que des tests supplémentaires avaient montré que cette méthode d’installation était parfois instable ou ne fonctionnait pas, et que la mise à jour automatique depuis l’interface web d’AzuraCast posait également des problèmes avec cette configuration. Cette correction ultérieure est plus importante que l’affirmation initiale selon laquelle la configuration fonctionnait parfaitement.
Configuration ZimaOS utilisée à l’origine
L’environnement source était un ZimaBoard équipé d’un Intel Celeron N3450, de 8 Go de mémoire, d’un circuit graphique Intel HD Graphics 500 et de ZimaOS 1.5.3 Plus. L’auteur a importé une définition Compose personnalisée d’AzuraCast via l’interface des applications personnalisées de ZimaOS.
La procédure était la suivante :
- Ouvrir le tableau de bord ZimaOS et choisir Installer une application personnalisée.
- Utiliser Importer et soumettre la définition Docker Compose.
- Vérifier les paramètres générés de web et updater avant l’installation.
- Modifier les ports côté hôte et les chemins de volumes côté ZimaOS sans changer les chemins correspondants des conteneurs AzuraCast.
- Installer l’application et ouvrir AzuraCast à l’aide de l’adresse du serveur et du port de l’interface web configuré.
La documentation actuelle de ZimaOS prend toujours en charge l’importation de fichiers YAML Docker Compose pour les applications personnalisées. Consultez la documentation actuelle des fonctionnalités de ZimaOS.
Associer les ports de l’hôte sans modifier ceux des conteneurs
Dans la configuration source, l’auteur a mis en évidence les correspondances côté hôte associées aux ports 80, 443 et 8000 des conteneurs AzuraCast. Il était recommandé de modifier les valeurs côté hôte afin qu’elles correspondent à l’installation ZimaOS locale, tout en laissant inchangées les valeurs côté conteneur.
L’onglet updater contenait également l’adresse de l’interface web. Le guide indique que ce port d’interface web doit correspondre au port côté hôte associé au port 80 du conteneur.
Conserver les chemins des conteneurs AzuraCast
L’auteur a également remappé le stockage persistant côté ZimaOS tout en laissant inchangés les chemins côté AzuraCast. La pile publiée comprenait le stockage des stations, des sauvegardes, des données MySQL, des téléversements, des composants facultatifs et un répertoire musical distinct.
Le guide déconseillait de modifier les variables d’environnement, sauf si l’administrateur en comprenait la fonction. Cette précaution est particulièrement importante, car les identifiants de l’application et les paramètres de la base de données peuvent être inclus dans les données d’environnement Compose.
Ne pas considérer le fichier Compose publié comme un modèle réutilisable de secrets
Le fichier YAML original du forum contient des valeurs d’environnement liées à la base de données. Une page communautaire ne doit pas transformer ces valeurs publiées en modèle d’identifiants réutilisable. Si vous recréez cette pile, utilisez des identifiants adaptés à votre propre installation et suivez les recommandations actuelles de configuration d’AzuraCast.
Pour obtenir les informations actuelles sur l’installation et la configuration en amont, consultez le guide officiel d’installation d’AzuraCast avec Docker.
L’auteur a ensuite signalé des problèmes de stabilité et de mise à jour
Neuf jours après la publication du guide, le même auteur a publié une correction importante : des expérimentations supplémentaires avaient montré que cette méthode ne fonctionnait parfois pas et pouvait être instable. L’auteur a également signalé des problèmes avec le processus de mise à jour automatique depuis l’interface web d’AzuraCast dans le cadre de cette méthode d’installation.
L’auteur a indiqué expérimenter une installation basée sur SSH et prévoir un guide de suivi plus détaillé, mais aucune procédure de remplacement n’a été publiée dans ce fil. Cette page doit donc être considérée comme la documentation d’une expérience communautaire présentant des limites connues, et non comme une méthode actuelle officiellement prise en charge pour installer AzuraCast sur ZimaOS.
Comparer la méthode communautaire aux recommandations actuelles d’AzuraCast
La documentation actuelle d’AzuraCast recommande Docker pour la plupart des installations auto-hébergées et propose son propre processus d’installation et de mise à jour avec Docker. Elle recommande également d’effectuer une sauvegarde avant toute mise à jour, car une interruption du service ou une perte de données peut survenir en cas d’échec.
Consultez la documentation officielle d’AzuraCast sur les mises à jour avant de vous fier au fonctionnement du programme de mise à jour de cette ancienne pile Compose pour ZimaOS.
Le guide source était destiné à un usage sur un réseau privé
L’auteur présentait explicitement le tutoriel comme destiné à un accès domestique ou privé sur le réseau local ou via Tailscale. Une exposition à Internet peut nécessiter des décisions supplémentaires concernant le réseau, TLS, le pare-feu, l’authentification et la sécurité de la diffusion, qui ne faisaient pas partie du sujet de la publication communautaire.
Ne supposez pas qu’une interface web locale fonctionnelle suffit à préparer un service de radio accessible au public.
FAQ : AzuraCast sur ZimaOS
L’auteur de la communauté a-t-il confirmé que cette méthode était stable ?
Non. La publication originale était optimiste, mais le suivi du 5 janvier 2026 indiquait explicitement que la méthode pouvait être instable ou échouer lors de certains tests.
Quelle version de ZimaOS a été utilisée ?
Le guide original utilisait ZimaOS 1.5.3 Plus sur un ZimaBoard. Considérez les captures d’écran et les paramètres d’application générés comme des exemples historiques plutôt que comme des instructions exactes pour toutes les versions ultérieures.
Dois-je modifier les chemins de volumes côté conteneur AzuraCast ?
Le guide source indique de modifier si nécessaire les chemins côté hôte ZimaOS tout en laissant inchangés les chemins côté conteneur AzuraCast.
Pourquoi le port de l’interface web du programme de mise à jour doit-il correspondre à la correspondance du service web ?
Dans la configuration source, l’entrée Web UI du programme de mise à jour pointait vers le port hôte associé au port 80 du conteneur. Une autre valeur redirigerait le raccourci ZimaOS vers le mauvais port.
La mise à jour automatique d’AzuraCast fonctionne-t-elle de manière fiable avec cette pile communautaire ?
L’auteur a spécifiquement signalé des problèmes avec la mise à jour automatique depuis l’interface web après des tests supplémentaires. Utilisez la documentation actuelle d’AzuraCast sur les mises à jour et conservez des sauvegardes, plutôt que de supposer que l’ancien conteneur updater est fiable.
