Le formulaire ZimaOS « Installer une application personnalisée » est beaucoup plus facile à utiliser une fois que l’on comprend qu’il traduit les concepts ordinaires de Docker Compose en champs. Le fil source de juin 2026 constitue un excellent exemple pour débutants, car l’utilisateur avait déjà configuré Jellyfin, souhaitait ajouter Subsyncarr pour le traitement des sous-titres et craignait de perturber son serveur multimédia existant.
La réponse de la communauté ne disait pas simplement « collez le fichier Compose ». Elle expliquait quelles valeurs correspondaient à Image Docker, Balise, Réseau, Volumes, Variables d’environnement, Périphériques et Commande du conteneur et, surtout, pourquoi des valeurs d’environnement telles que SCAN_PATHS doivent utiliser des chemins visibles à l’intérieur du conteneur.
Interprétez le formulaire ZimaOS comme une configuration Docker
Pour l’exemple source, la communauté a approximativement associé les champs Compose de base comme suit :
- Image Docker →
mrorbitman/subsyncarr - Balise → la balise de version souhaitée, historiquement
latest - Titre → un nom d’application convivial tel que
Subsyncarr - Réseau →
bridgesauf si les instructions actuelles de l’application exigent autre chose
Utilisez l’exemple Compose en amont comme source de référence
Subsyncarr a continué d’évoluer. Avant l’installation, comparez donc toute ancienne capture d’écran de la communauté avec les paramètres actuels du conteneur Subsyncarr.
Les volumes sont la partie la plus importante
Un volume Docker a deux côtés :
- Chemin de l’hôte : le véritable dossier ZimaOS contenant les films, les séries TV, les animés ou les données de l’application.
- Chemin du conteneur : le chemin que Subsyncarr voit dans son propre système de fichiers.
Un mappage pourrait conceptuellement se présenter ainsi :
Hôte : /DATA/Media/Movies
Conteneur : /moviesLe dossier exact de l’hôte dépend de l’emplacement réel de votre bibliothèque Jellyfin. Ne copiez pas le chemin d’un autre utilisateur. Vérifiez l’application Fichiers de ZimaOS ou examinez les mappages de volumes existants de Jellyfin afin que les deux conteneurs pointent vers les mêmes fichiers multimédias.
L’explication actuelle de la manière dont les véritables dossiers de stockage de ZimaOS deviennent des chemins de conteneur est utile avant d’ajouter une application multimédia personnalisée.
SCAN_PATHS doit correspondre au côté conteneur
C’était le point pédagogique essentiel de la réponse originale. Si le dossier de l’hôte est mappé vers /movies à l’intérieur du conteneur ; Subsyncarr devrait alors analyser /movies.
Correct :
SCAN_PATHS=/movies,/tv,/animeIncorrect lorsque ceux-ci sont uniquement des chemins de l’hôte :
SCAN_PATHS=/DATA/Media/MoviesLe conteneur ne peut pas accéder à des chemins arbitraires de l’hôte ZimaOS, sauf si ces dossiers y ont été explicitement mappés.
Traduisez les variables d’environnement une par une
L’exemple Compose source incluait des variables telles que le fuseau horaire, la planification cron, les chemins d’analyse, les répertoires exclus et les moteurs de synchronisation. Ajoutez chacune d’elles à la section des variables d’environnement en conservant la même sémantique de valeurs que celle attendue par l’application en amont.
N’« améliorez » pas une expression cron et ne renommez pas un chemin de conteneur lors de la traduction. Reproduisez d’abord fidèlement la configuration en amont, puis apportez des modifications une fois que l’application fonctionne correctement.
Les versions actuelles de Subsyncarr disposent d’une interface Web
La réponse de la communauté en 2026 conseillait de laisser l’interface Web et les ports vides, sauf si la documentation indiquait que l’application en exposait un. Ce conseil était correct pour une application inconnue, mais les versions actuelles de Subsyncarr proposent désormais une interface Web sur le port 3000 ainsi que des données d’application persistantes.
Si vous voulez utiliser le tableau de bord, publiez un port de l’hôte vers le port 3000 du conteneur et définissez le champ Interface web de ZimaOS sur cette adresse de l’hôte. Si le port est déjà utilisé, modifiez uniquement le côté hôte, sauf si le projet en amont indique que le port du service interne lui-même est configurable.
Conservez les propres données d’application de Subsyncarr
Les dossiers multimédias ne sont pas les seuls volumes importants. La version actuelle de Subsyncarr possède également ses propres données persistantes. Conservez l’état de cette application dans un dossier hôte qui survit aux mises à jour du conteneur et incluez-le dans vos sauvegardes.
PUID et PGID sont importants lorsque les sous-titres doivent être écrits
Un processeur de sous-titres a besoin de plus qu’un simple accès en lecture. Il peut devoir créer, renommer ou modifier les fichiers de sous-titres à côté des fichiers multimédias. La version actuelle de Subsyncarr prend en charge PUID et PGID : alignez donc l’utilisateur du conteneur sur le propriétaire ou les autorisations de groupe des dossiers multimédias si les analyses fonctionnent mais que l’écriture des sous-titres échoue.
Laissez les champs Périphériques et Commande du conteneur vides, sauf si le projet en amont l’exige
La réponse de la communauté recommandait à juste titre de ne pas remplir tous les champs simplement parce qu’ils existent. Une association de périphérique sert au matériel tel que les GPU ou les périphériques série. La commande du conteneur remplace la commande de démarrage par défaut de l’image. Aucun de ces éléments ne doit être ajouté sans exigence précise du projet en amont.
Pourquoi cela ne devrait pas perturber Jellyfin
L’ajout d’un conteneur séparé ne modifie pas Jellyfin simplement parce que les deux applications lisent le même dossier multimédia. Le principal risque concerne les autorisations : si Subsyncarr est autorisé à renommer ou à écrire des fichiers, vérifiez que sa configuration ne touche qu’aux chemins multimédias et de sous-titres prévus.
Commencez par une petite bibliothèque de test avant de configurer l’application pour toute la collection.
FAQ sur les applications personnalisées de ZimaOS
SCAN_PATHS utilise-t-il le chemin de l’hôte ou celui du conteneur ?
Utilisez les chemins des conteneurs créés par vos associations de volumes.
Dois-je remplir tous les champs du formulaire d’application personnalisée de ZimaOS ?
Non. Configurez uniquement les ports, les périphériques, les commandes et les autres champs dont l’application a réellement besoin.
La version actuelle de Subsyncarr dispose-t-elle d’une interface web ?
Oui. Les versions actuelles exposent un tableau de bord sur le port 3000.
Subsyncarr peut-il utiliser les mêmes dossiers multimédias que Jellyfin ?
Oui, à condition que les deux conteneurs associent les mêmes dossiers réels de l’hôte et que leurs autorisations soient appropriées.
