Il modulo «Installa un'app personalizzata» di ZimaOS è molto più facile da usare una volta riconosciuto che sta traducendo i normali concetti di Docker Compose in campi. La discussione di origine del giugno 2026 è un ottimo esempio per principianti, perché l'utente aveva già Jellyfin funzionante, voleva aggiungere Subsyncarr per l'elaborazione dei sottotitoli ed era preoccupato di compromettere il server multimediale esistente.
La risposta della community non si è limitata a dire «incolla il file Compose». Ha spiegato quali valori inserire in Immagine Docker, Tag, Rete, Volumi, Variabili d'ambiente, Dispositivi e Comando del container e, soprattutto, perché valori dell'ambiente come SCAN_PATHS devono usare percorsi visibili all'interno del container.
Leggi il modulo ZimaOS come configurazione Docker
Per l'esempio di origine, la community ha associato approssimativamente i campi Compose di base in questo modo:
- Immagine Docker →
mrorbitman/subsyncarr - Tag → il tag di rilascio desiderato, storicamente
latest - Titolo → un nome intuitivo per l'app, come
Subsyncarr - Rete →
bridgea meno che le istruzioni attuali dell'app non richiedano altro
Usa l'esempio Compose upstream come fonte di verità
Subsyncarr ha continuato a evolversi, quindi prima dell'installazione confronta qualsiasi vecchio screenshot della community con le impostazioni attuali del container Subsyncarr.
I volumi sono la parte più importante
Un volume Docker ha due lati:
- Percorso dell'host: la vera cartella ZimaOS che contiene film, serie TV, anime o dati dell'applicazione.
- Percorso del container: il percorso che Subsyncarr vede all'interno del proprio filesystem.
Una mappatura potrebbe avere concettualmente questo aspetto:
Host: /DATA/Media/Movies
Container: /moviesLa cartella esatta dell'host dipende da dove si trova effettivamente la libreria Jellyfin. Non copiare il percorso di un altro utente. Controlla l'app File di ZimaOS oppure esamina le mappature dei volumi già esistenti di Jellyfin, in modo che entrambi i container puntino agli stessi contenuti multimediali.
L'attuale spiegazione di come le vere cartelle di archiviazione ZimaOS diventano percorsi del container è utile prima di aggiungere qualsiasi applicazione multimediale personalizzata.
SCAN_PATHS deve corrispondere al lato del container
Questo era il punto didattico principale della risposta originale. Se la cartella dell'host è mappata su /movies all'interno del container; a quel punto Subsyncarr dovrebbe eseguire la scansione di /movies.
Corretto:
SCAN_PATHS=/movies,/tv,/animeErrato quando questi sono solo percorsi dell'host:
SCAN_PATHS=/DATA/Media/MoviesIl container non può vedere percorsi arbitrari dell'host ZimaOS, a meno che tali cartelle non siano state mappate esplicitamente al suo interno.
Traduci le variabili d'ambiente una per una
L'esempio Compose originale includeva variabili come il fuso orario, la pianificazione cron, i percorsi da scansionare, le directory escluse e i motori di sincronizzazione. Inserisci ciascuna nella sezione Variabili d'ambiente, usando la stessa semantica dei valori prevista dall'applicazione originale.
Non “migliorare” un'espressione cron né rinominare un percorso del container durante la traduzione. Prima riproduci fedelmente la configurazione originale, poi apporta modifiche dopo aver verificato che l'app funzioni.
Le versioni attuali di Subsyncarr hanno una Web UI
La risposta della community del 2026 consigliava di lasciare vuoti Web UI e Porte, a meno che la documentazione non indicasse che l'applicazione ne esponeva una. Quel consiglio era corretto per un'applicazione sconosciuta, ma le versioni attuali di Subsyncarr ora offrono una Web UI sulla porta 3000 e dati persistenti dell'applicazione.
Se vuoi la dashboard, pubblica una porta dell’host sulla porta 3000 del container e imposta il campo Web UI di ZimaOS sull’indirizzo dell’host. Se la porta è già in uso, modifica solo il lato host, salvo che il progetto upstream indichi che la porta del servizio interno sia configurabile.
Rendi persistenti i dati dell’applicazione di Subsyncarr
Le cartelle multimediali non sono gli unici volumi importanti. La versione attuale di Subsyncarr dispone anche di dati persistenti propri. Conserva lo stato dell’applicazione in una cartella dell’host che sopravviva agli aggiornamenti del container e includila nei backup.
PUID e PGID sono importanti quando è necessario scrivere i sottotitoli
Un elaboratore di sottotitoli ha bisogno di più del semplice accesso in lettura. Potrebbe dover creare, rinominare o modificare i file dei sottotitoli accanto ai contenuti multimediali. La versione attuale di Subsyncarr supporta PUID e PGID, quindi assegna al container lo stesso utente o gruppo proprietario delle cartelle multimediali, se le scansioni funzionano ma la scrittura dei sottotitoli non riesce.
Lascia vuoti Devices e Container Command, salvo diversa richiesta del progetto upstream
La risposta della community consigliava correttamente di non compilare ogni campo solo perché presente. Un mapping di dispositivo serve per hardware come GPU o dispositivi seriali. Container Command sostituisce il comando di avvio predefinito dell’immagine. Nessuno dei due dovrebbe essere aggiunto senza uno specifico requisito del progetto upstream.
Perché questo non dovrebbe compromettere Jellyfin
L’aggiunta di un container separato non modifica Jellyfin solo perché entrambe le applicazioni leggono la stessa cartella multimediale. Il rischio maggiore riguarda le autorizzazioni: se Subsyncarr può rinominare o scrivere i file, assicurati che la sua configurazione agisca solo sui percorsi multimediali e dei sottotitoli desiderati.
Inizia con una piccola libreria di test prima di indicare all’applicazione l’intera raccolta.
FAQ sulle app personalizzate di ZimaOS
SCAN_PATHS usa il percorso dell’host o quello del container?
Usa i percorsi dei container creati dai tuoi mapping dei volumi.
Devo compilare ogni campo nel modulo delle app personalizzate di ZimaOS?
No. Configura solo le porte, i dispositivi, i comandi e gli altri campi effettivamente necessari all’applicazione.
La versione attuale di Subsyncarr dispone di un’interfaccia web?
Sì. Le versioni attuali espongono una dashboard sulla porta 3000.
Subsyncarr può usare le stesse cartelle multimediali di Jellyfin?
Sì, purché entrambi i container mappino le stesse cartelle reali dell’host e dispongano delle autorizzazioni appropriate.
