Soluzione della community

Esegui ONLYOFFICE Workspace su ZimaOS senza scrivere nella radice in sola lettura

A January 2026 troubleshooting thread about a multi-container ONLYOFFICE Workspace deployment that originally required /app on a read-only ZimaOS root. The user later reported a definitive supplier-supported solution: change the install base directory to persistent storage and explicitly select the Community installation type.

Alcuni programmi di installazione Docker dei fornitori presumono di poter creare direttamente le directory delle applicazioni nel filesystem root di Linux. Questo entra in conflitto con il design di ZimaOS in stile appliance quando un programma di installazione richiede un percorso sull’host come /app.

Questa discussione di gennaio 2026 è infine arrivata a una soluzione migliore rispetto a rendere scrivibile il filesystem root di ZimaOS: configurare ONLYOFFICE Workspace affinché utilizzi lo storage persistente sotto /media e selezionare esplicitamente il tipo di installazione Community.

Non rendere scrivibile il root di ZimaOS solo per soddisfare un programma di installazione

La distribuzione originale era composta da più container per database, ricerca, documenti, posta, comunicazioni e servizi di gestione. Il programma di installazione del fornitore si aspettava /app, mentre l’utente voleva archiviare i dati effettivi su un’unità dati ZimaOS di grandi dimensioni.

La community ha correttamente spostato la discussione dall’idea di modificare in modo permanente il filesystem di base di ZimaOS. Gli aggiornamenti di un sistema operativo appliance possono sostituire o invalidare le modifiche non supportate apportate al filesystem root.

Il programma di installazione del fornitore aveva una directory di base configurabile

Dopo aver esaminato gli script di installazione, l’utente ha scoperto che la posizione dello storage non era effettivamente codificata nello script. La directory di base poteva essere modificata dal percorso predefinito a livello root a una posizione persistente sull’unità dati di ZimaOS.

Questa è un’architettura più sicura, perché i container e i dati delle applicazioni rimangono su uno storage scrivibile, mentre l’immagine di sistema di ZimaOS resta gestita dal sistema operativo.

Selezionare esplicitamente il tipo di installazione Community

In seguito, l’utente ha segnalato un secondo problema: dopo aver modificato la directory di base, il programma di installazione poteva selezionare automaticamente l’edizione Enterprise. Dopo aver collaborato con il fornitore del software, ha confermato che per la distribuzione Community era necessario selezionare il tipo di installazione appropriato.

Le istruzioni attuali di ONLYOFFICE mostrano ancora separatamente i tipi di installazione Community ed Enterprise. Prima di modificare uno script scaricato in precedenza, verifica quali parametri dello script selezionano Workspace Community nel programma di installazione attuale.

Utilizzare lo script ONLYOFFICE attuale, non il nome file storico del forum

La risposta del forum del 2026 faceva riferimento a un nome file del programma di installazione ormai obsoleto. Le istruzioni attuali di ONLYOFFICE Workspace pubblicano ora workspace-install.sh per le distribuzioni Docker e documentano separatamente i parametri supportati.

Il processo upstream attuale e i requisiti di sistema sono descritti nel flusso di installazione Docker gestito per Workspace Community.

Docker Compose resta un’alternativa più trasparente

La discussione della community ha preso in considerazione anche la distribuzione dello stack tramite Compose, invece di affidarsi a un grande script di installazione. Questo approccio facilita la revisione delle edizioni delle immagini, dei percorsi dei volumi, delle reti e dello storage persistente prima della distribuzione.

Se importi uno stack composto da più container nell’attuale ZimaOS, le impostazioni runtime standard appartengono a Docker Compose. La spiegazione attuale di come ZimaOS gestisce la configurazione Docker Compose aiuta a mantenere separati i percorsi di storage del fornitore dai metadati delle app ZimaOS.

Domande frequenti su ONLYOFFICE in ZimaOS

Devo rendere scrivibile il filesystem root di ZimaOS?

No. Nessuna soluzione presentata nella discussione finale lo richiedeva. L’approccio migliore consisteva nel collocare la directory di base del fornitore su uno storage persistente scrivibile.

/app era davvero obbligatorio?

Il fornitore dell’utente ha infine confermato che la directory di base del programma di installazione poteva essere modificata; quindi l’host non doveva archiviare l’applicazione nel percorso /app a livello root.

Perché compariva l’edizione sbagliata?

L’utente ha scoperto che la modifica della directory di base rendeva evidente un comportamento del programma di installazione che selezionava per impostazione predefinita Enterprise. Ha riferito che la selezione esplicita del tipo di installazione Community ha risolto il problema.

Devo copiare esattamente i comandi del forum del 2026?

No. Prima della distribuzione, è opportuno verificare il nome file e i parametri attuali del programma di installazione di ONLYOFFICE confrontandoli con le istruzioni aggiornate.