Rozwiązanie społecznościowe

Uruchom ONLYOFFICE Workspace w systemie ZimaOS bez zapisywania danych w katalogu głównym tylko do odczytu

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.

Niektóre instalatory Dockera dostarczane przez producentów zakładają, że mogą tworzyć katalogi aplikacji bezpośrednio w głównym systemie plików Linuksa. Koliduje to z konstrukcją ZimaOS w stylu urządzenia appliance, gdy instalator wymaga ścieżki hosta takiej jak /app.

Wątek ze stycznia 2026 roku ostatecznie doprowadził do lepszego rozwiązania niż nadawanie uprawnień do zapisu głównemu systemowi plików ZimaOS: skonfigurowania ONLYOFFICE Workspace tak, aby używał trwałego magazynu w /media, oraz wyraźnego wybrania typu instalacji Community.

Nie nadawaj uprawnień do zapisu głównemu systemowi plików ZimaOS tylko po to, aby spełnić wymagania instalatora

Pierwotne wdrożenie składało się z wielu kontenerów obsługujących bazę danych, wyszukiwanie, dokumenty, pocztę, komunikację i usługi zarządzania. Instalator producenta oczekiwał ścieżki /app, podczas gdy użytkownik chciał przechowywać rzeczywiste dane na dużym dysku danych ZimaOS.

Społeczność słusznie skierowała dyskusję z dala od trwałego modyfikowania bazowego systemu plików ZimaOS. Aktualizacje systemu typu appliance mogą zastąpić lub unieważnić nieobsługiwane zmiany w głównym systemie plików.

Instalator producenta miał konfigurowalny katalog bazowy

Po przeanalizowaniu skryptów instalatora użytkownik dowiedział się, że lokalizacja magazynu nie była w rzeczywistości zakodowana na stałe. Katalog bazowy można było zmienić z domyślnej ścieżki na poziomie katalogu głównego na trwałą lokalizację na dysku danych ZimaOS.

Jest to bezpieczniejsza architektura, ponieważ kontenery i dane aplikacji pozostają na zapisywalnym nośniku, a obraz systemu ZimaOS nadal jest zarządzany przez system operacyjny.

Wyraźnie wybierz typ instalacji Community

Użytkownik zgłosił później drugi problem: po zmianie katalogu bazowego instalator mógł przełączyć się na wersję Enterprise. Po konsultacji z dostawcą oprogramowania potwierdzono, że wdrożenie Community wymagało odpowiedniego wyboru typu instalacji.

Aktualne instrukcje ONLYOFFICE nadal udostępniają osobne typy instalacji Community i Enterprise. Przed modyfikacją starego pobranego skryptu sprawdź, które parametry skryptu wybierają Workspace Community w aktualnym instalatorze.

Użyj aktualnego skryptu ONLYOFFICE, a nie historycznej nazwy pliku z forum

Odpowiedź na forum z 2026 roku odwoływała się do starszej nazwy pliku instalatora. Aktualne instrukcje ONLYOFFICE Workspace publikują teraz plik workspace-install.sh do wdrożeń Dockera i opisują obsługiwane parametry osobno.

Aktualny proces dostawcy oraz wymagania systemowe opisano w utrzymywanej instrukcji wdrażania Workspace Community za pomocą Dockera.

Docker Compose pozostaje bardziej przejrzystą alternatywą

W dyskusji społeczności rozważano również wdrożenie stosu za pomocą Compose zamiast korzystania z dużego skryptu instalacyjnego. Takie podejście ułatwia sprawdzenie przed wdrożeniem wersji obrazów, ścieżek woluminów, sieci i trwałego magazynu.

Jeśli importujesz stos wielu kontenerów do aktualnego ZimaOS, standardowe ustawienia uruchomieniowe powinny znajdować się w Docker Compose. Aktualne wyjaśnienie sposobu obsługi konfiguracji Docker Compose przez ZimaOS pomaga oddzielić ścieżki magazynu dostawcy od metadanych aplikacji ZimaOS.

ONLYOFFICE w ZimaOS — często zadawane pytania

Czy muszę nadać uprawnienia do zapisu głównemu systemowi plików ZimaOS?

Żadne rozwiązanie przedstawione w finalnej części wątku nie wymagało takiego działania. Lepszym podejściem było umieszczenie katalogu bazowego dostawcy na zapisywalnym, trwałym magazynie.

Czy ścieżka /app była rzeczywiście obowiązkowa?

Dostawca użytkownika ostatecznie potwierdził, że katalog bazowy instalatora można było zmienić, więc host nie musiał przechowywać aplikacji w znajdującej się w katalogu głównym ścieżce /app.

Dlaczego pojawiała się niewłaściwa wersja?

Użytkownik odkrył, że zmiana katalogu bazowego ujawniała działanie instalatora, który domyślnie wybierał wersję Enterprise. Zgłosił, że wyraźne wybranie typu instalacji Community rozwiązało ten problem.

Czy powinienem dokładnie skopiować polecenia z forum z 2026 roku?

Nie. Przed wdrożeniem należy sprawdzić aktualną nazwę pliku instalatora ONLYOFFICE i jego parametry w utrzymywanych instrukcjach.