Community-Lösung

ONLYOFFICE Workspace auf ZimaOS ausführen, ohne in das schreibgeschützte Root-Dateisystem zu schreiben

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.

Einige Docker-Installer von Anbietern gehen davon aus, dass sie Anwendungsverzeichnisse direkt im Linux-Root-Dateisystem anlegen können. Das steht im Konflikt mit dem Appliance-Design von ZimaOS, wenn ein Installer auf einem Host-Pfad wie /app besteht.

Dieser Thread vom Januar 2026 gelangte schließlich zu einer besseren Lösung, als das Root-Dateisystem von ZimaOS beschreibbar zu machen: ONLYOFFICE Workspace sollte persistenten Speicher unter /media verwenden, und als Installationstyp sollte ausdrücklich die Community-Edition ausgewählt werden.

Das ZimaOS-Root-Dateisystem nicht nur für einen Installer beschreibbar machen

Die ursprüngliche Bereitstellung bestand aus mehreren Containern für Datenbank-, Such-, Dokumenten-, Mail-, Kommunikations- und Verwaltungsdienste. Der Installer des Anbieters erwartete /app, während der Benutzer die tatsächlichen Daten auf einem großen ZimaOS-Datenlaufwerk speichern wollte.

Die Community lenkte die Diskussion richtigerweise davon weg, das Basisdateisystem von ZimaOS dauerhaft zu verändern. Betriebssystem-Updates für Appliance-Systeme können nicht unterstützte Änderungen im Root-Dateisystem ersetzen oder ungültig machen.

Der Installer des Anbieters hatte ein konfigurierbares Basisverzeichnis

Nachdem die Installationsskripte überprüft worden waren, stellte der Benutzer fest, dass der Speicherort nicht tatsächlich fest einprogrammiert war. Das Basisverzeichnis konnte vom standardmäßigen Pfad auf Root-Ebene auf einen persistenten Speicherort unter dem ZimaOS-Datenlaufwerk geändert werden.

Das ist eine sicherere Architektur, da Container und Anwendungsdaten auf beschreibbarem Speicher verbleiben, während das ZimaOS-Systemabbild vom Betriebssystem verwaltet wird.

Den Installationstyp Community ausdrücklich auswählen

Später meldete der Benutzer ein zweites Problem: Nach der Änderung des Basisverzeichnisses konnte der Installer auf die Enterprise-Edition zurückfallen. Nach Rücksprache mit dem Softwareanbieter wurde bestätigt, dass für die Community-Bereitstellung die passende Auswahl des Installationstyps erforderlich war.

Die aktuellen ONLYOFFICE-Anweisungen enthalten weiterhin getrennte Installationstypen für Community und Enterprise. Bevor Sie ein älteres heruntergeladenes Skript ändern, prüfen Sie, welche Skriptparameter im aktuellen Installer Workspace Community auswählen.

Das aktuelle ONLYOFFICE-Skript verwenden, nicht den historischen Dateinamen aus dem Forum

In der Forumsantwort von 2026 wurde ein älterer Dateiname des Installers genannt. In den aktuellen ONLYOFFICE-Workspace-Anweisungen wird für Docker-Bereitstellungen nun workspace-install.sh veröffentlicht; die unterstützten Parameter sind separat dokumentiert.

Der aktuelle Prozess des Anbieters und die Systemanforderungen werden im gepflegten Docker-Installationsablauf für Workspace Community beschrieben.

Docker Compose bleibt eine transparentere Alternative

In der Community-Diskussion wurde außerdem erwogen, den Stack statt über ein umfangreiches Installationsskript mit Compose bereitzustellen. Dieser Ansatz erleichtert es, Image-Editionen, Volume-Pfade, Netzwerke und persistenten Speicher vor der Bereitstellung zu überprüfen.

Wenn Sie einen Stack mit mehreren Containern in das aktuelle ZimaOS importieren, gehören die standardmäßigen Laufzeiteinstellungen in Docker Compose. Die aktuelle Erklärung dazu, wie ZimaOS die Docker-Compose-Konfiguration verarbeitet, hilft dabei, die Speicherpfade des Anbieters von den App-Metadaten von ZimaOS getrennt zu halten.

ONLYOFFICE auf ZimaOS – FAQ

Muss ich das ZimaOS-Root-Dateisystem beschreibbar machen?

Nein. Keine Lösung im abschließenden Thread erforderte dies. Der bessere Ansatz bestand darin, das Basisverzeichnis des Anbieters auf beschreibbaren persistenten Speicher zu legen.

War /app wirklich zwingend erforderlich?

Der Anbieter des Benutzers bestätigte letztlich, dass das Basisverzeichnis des Installers geändert werden konnte. Der Host musste die Anwendung daher nicht im Pfad /app auf Root-Ebene speichern.

Warum wurde die falsche Edition angezeigt?

Der Benutzer stellte fest, dass die Änderung des Basisverzeichnisses ein Verhalten des Installers sichtbar machte, bei dem standardmäßig die Enterprise-Edition ausgewählt wurde. Er berichtete, dass die ausdrückliche Auswahl des Installationstyps Community dieses Problem löste.

Soll ich die Befehle aus dem Forum von 2026 genau kopieren?

Nein. Der aktuelle Dateiname und die aktuellen Parameter des ONLYOFFICE-Installers sollten vor der Bereitstellung anhand der gepflegten Anweisungen überprüft werden.