Communityoplossing

Voer ONLYOFFICE Workspace uit op ZimaOS zonder naar de alleen-lezen hoofdmap te schrijven

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.

Sommige Docker-installatieprogramma's van leveranciers gaan ervan uit dat ze applicatiemappen rechtstreeks onder het Linux-rootbestandssysteem kunnen aanmaken. Dat botst met het appliance-achtige ontwerp van ZimaOS wanneer een installatieprogramma een hostpad zoals /app vereist.

In deze discussie uit januari 2026 werd uiteindelijk een betere oplossing gevonden dan het schrijfbaar maken van het ZimaOS-rootbestandssysteem: configureer ONLYOFFICE Workspace om persistente opslag onder /media te gebruiken en selecteer expliciet het installatietype Community.

Maak het ZimaOS-rootbestandssysteem niet schrijfbaar om alleen aan een installatieprogramma te voldoen

De oorspronkelijke implementatie bestond uit meerdere containers voor database-, zoek-, document-, mail-, communicatie- en beheerdiensten. Het installatieprogramma van de leverancier verwachtte /app, terwijl de gebruiker de daadwerkelijke gegevens op een grote ZimaOS-gegevensschijf wilde opslaan.

De community stuurde de discussie terecht weg van het permanent aanpassen van het basisbestandssysteem van ZimaOS. Updates van appliance-besturingssystemen kunnen niet-ondersteunde wijzigingen onder het rootbestandssysteem vervangen of ongeldig maken.

Het installatieprogramma van de leverancier had een configureerbare basismap

Na inspectie van de installatiescripts ontdekte de gebruiker dat de opslaglocatie niet daadwerkelijk hardgecodeerd was. De basismap kon worden gewijzigd van het standaardpad op rootniveau naar een persistente locatie op de ZimaOS-gegevensschijf.

Dat is een veiligere architectuur, omdat containers en applicatiegegevens op schrijfbare opslag blijven staan terwijl de ZimaOS-systeemimage door het besturingssysteem wordt beheerd.

Selecteer expliciet het installatietype Community

De gebruiker meldde later een tweede probleem: nadat de basismap was gewijzigd, kon het installatieprogramma terugvallen op de Enterprise-editie. Na overleg met de softwareleverancier werd bevestigd dat voor de Community-implementatie het juiste installatietype moest worden geselecteerd.

De huidige ONLYOFFICE-instructies bieden nog steeds afzonderlijke installatietypen voor Community en Enterprise. Controleer voordat je een oud gedownload script wijzigt welke scriptparameters Workspace Community in het huidige installatieprogramma selecteren.

Gebruik het huidige ONLYOFFICE-script, niet de historische bestandsnaam uit het forum

In het forumantwoord uit 2026 werd een oudere bestandsnaam van het installatieprogramma genoemd. De huidige ONLYOFFICE Workspace-instructies publiceren nu workspace-install.sh voor Docker-implementaties en documenteren de ondersteunde parameters afzonderlijk.

Het huidige upstream-proces en de systeemvereisten worden beschreven in de bijgehouden Docker-installatieworkflow voor Workspace Community.

Docker Compose blijft een transparanter alternatief

In de discussie van de community werd ook overwogen om de stack met Compose te implementeren in plaats van te vertrouwen op een groot installatiescript. Met die aanpak zijn image-edities, volumepaden, netwerken en persistente opslag vóór de implementatie eenvoudiger te controleren.

Als je een stack met meerdere containers importeert in het huidige ZimaOS, horen standaard runtime-instellingen thuis in Docker Compose. De huidige uitleg over de manier waarop ZimaOS Docker Compose-configuratie verwerkt helpt om opslagpaden van de leverancier gescheiden te houden van metadata van ZimaOS-apps.

Veelgestelde vragen over ONLYOFFICE op ZimaOS

Moet ik het ZimaOS-rootbestandssysteem schrijfbaar maken?

Nee. Voor geen enkele oplossing in de uiteindelijke discussie was dat nodig. De betere aanpak was om de basismap van de leverancier op schrijfbare persistente opslag te plaatsen.

Was /app echt verplicht?

De leverancier van de gebruiker bevestigde uiteindelijk dat de basismap van het installatieprogramma kon worden gewijzigd. De host hoefde de applicatie dus niet op te slaan onder het pad /app op rootniveau.

Waarom verscheen de verkeerde editie?

De gebruiker ontdekte dat het wijzigen van de basismap installatiegedrag blootlegde waarbij standaard de Enterprise-editie werd geselecteerd. Volgens de gebruiker loste het expliciet selecteren van het installatietype Community dat probleem op.

Moet ik de forumopdrachten uit 2026 exact kopiëren?

Nee. Controleer vóór de implementatie de huidige bestandsnaam en parameters van het ONLYOFFICE-installatieprogramma aan de hand van de bijgehouden instructies.