ONLYOFFICE Docs Enterprise mit der offiziellen Compose-Datei bereitstellen

Für eine Einzelhost-Bereitstellung verwenden Sie die offizielle ONLYOFFICE-Version docker-compose.enterprise.ymlaus dem Docker-DocumentServer-Repository und starten Sie sie mit Docker Compose v2. Bevor Sie den Stack online schalten, ersetzen Sie die Beispiel-Zugangsdaten, legen Sie ein stabiles JWT-Geheimnis für Ihre Integration fest und binden Sie das Verzeichnis ein, das Ihre Enterprise-Lizenz und die persistenten Daten enthält. Ein laufender Container ist nur die erste Prüfung: Überprüfen Sie den Compose-Status und öffnen Sie die Docs-Willkommensseite, bevor Sie eine Produktionsplattform verbinden.

Was beginnt die Enterprise Compose-Datei?

Die offizielle Datei definiert den Document Server Enterprise-Dienst sowie die Abhängigkeiten PostgreSQL, RabbitMQ und Redis. Sie veröffentlicht die HTTP- und HTTPS-Ports des Editors und beinhaltet eine Integritätsprüfung für den internen Endpunkt für Docs-Informationen. Dank dieser Abhängigkeiten eignet sich diese Compose-Datei ideal für kleine Installationen auf einem einzelnen Host. Sie konfiguriert jedoch weder den Plattform-Connector noch das öffentliche DNS oder ein TLS-Zertifikat für den Produktiveinsatz.

Stand 9. Oktober 2026 verwendet die offizielle Datei PostgreSQL 15, RabbitMQ 3 und Redis 7. Da sich Repository-Dateien ändern können, überprüfen Sie bitte die aktuelle Enterprise Compose-Datei vor der Bereitstellung und Aktualisierung.

1. Überprüfen Sie den Host und installieren Sie Docker Compose.

Die Enterprise-Docker-Anforderungen von ONLYOFFICE nennen einen amd64-Linux-Host mit Kernel 3.10 oder höher, Docker-Unterstützung durch die Entwickler, mindestens 4 GB RAM, 40 GB freien Festplattenspeicher und mindestens 4 GB Swap-Speicher. Die empfohlene Größe variiert je nach Anzahl und Art der gleichzeitig geöffneten Dokumente. Verwenden Sie diese Angaben daher als Ausgangspunkt und nicht als Kapazitätsgarantie. Ein Produktionsportal mit höherer Auslastung benötigt möglicherweise mehr Ressourcen.

Installieren Sie Docker Engine und das Compose-Plugin gemäß der offiziellen Docker-Anleitung für Ihre Linux-Distribution. Stellen Sie sicher, dass beide Befehle funktionieren, bevor Sie das Repository klonen:

docker --version
docker compose version

Falls auf dem Host bereits ein Webserver vorhanden ist, prüfen Sie, ob die Ports 80 und 443 verfügbar sind, oder planen Sie einen Reverse-Proxy und eine alternative Portweiterleitung auf dem Host. Die Compose-Datei startet außerdem die Datenbank-, Warteschlangen- und Cache-Dienste; diese sollten im privaten Compose-Netzwerk verbleiben und nicht über öffentliche Ports veröffentlicht werden.

2. Laden Sie die offizielle Compose-Datei herunter.

Klonen Sie das Repository von ONLYOFFICE und wechseln Sie in dessen Verzeichnis:

git clone https://github.com/ONLYOFFICE/Docker-DocumentServer
cd Docker-DocumentServer

Prüfen Sie, ob dies docker-compose.enterprise.ymlvorhanden ist. Die README-Datei des Repositorys gibt für die Enterprise Edition folgenden Befehl an:

docker compose -f docker-compose.enterprise.yml up -d

3. Anmeldeinformationen, JWT und einen dauerhaften Lizenzspeicherort festlegen

Starten Sie die Beispielkonfiguration von Compose nicht unverändert auf einem Host mit Internetzugang. Die veröffentlichte Datei enthält Beispiel-Datenbankzugangsdaten und kommentiert explizite JWT-Werte aus. Ersetzen Sie das PostgreSQL-Passwort sowohl im Datenbankdienst als auch in den DB_PWDEinstellungen des Dokumentenservers durch ein sicheres Passwort. Halten Sie die Ports für Datenbank, RabbitMQ und Redis privat.

Für die Integration legen Sie ein stabiles JWT-Geheimnis im Dokumentenserver-Dienst fest und konfigurieren Sie dasselbe Geheimnis im ONLYOFFICE-Connector Ihrer Plattform. Eine einfache Methode besteht darin, den Wert in einer lokalen .envDatei zu speichern, die Sie nicht in Git einchecken, und anschließend die Variablenersetzung in Compose zu verwenden. Fügen Sie diese Einträge dem Abschnitt „Umgebung“ des Dokumentenservers hinzu und passen Sie das bestehende Umgebungsformat gegebenenfalls an.

- JWT_ENABLED=true
- JWT_SECRET=${JWT_SECRET}

Verwenden Sie einen langen, eindeutigen Wert .envals JWT_SECRET=.... Kopieren Sie den Platzhalter nicht in eine Live-Konfiguration. ONLYOFFICE dokumentiert JWT ab Version 7.2 standardmäßig mit einem automatisch generierten Geheimnis. Durch die Angabe eines eigenen, stabilen Werts vermeiden Sie Konflikte beim Neuerstellen des Containers. Weitere Informationen finden Sie im JWT-Konfigurationsleitfaden .

Um Enterprise mit einer erworbenen Lizenz zu registrieren license.lic, binden Sie ein Hostverzeichnis /var/www/onlyoffice/Datain den Document Server-Dienst ein. Ersetzen Sie beispielsweise die anonyme Dateneinbindung durch die entsprechende Einbindung ./documentserver-data:/var/www/onlyoffice/Data, erstellen Sie dieses Hostverzeichnis und platzieren Sie license.licdie Lizenzdatei vor dem Start darin. Achten Sie darauf, die Dateiberechtigungen beizubehalten und das Verzeichnis in Ihrer Datensicherung zu sichern. Die Registrierungsanleitung für Enterprise bestätigt, dass sich die Lizenzdatei in einem für Docker eingebundenen Ordner befinden muss.

4. Starten Sie den Enterprise-Stack.

Führen Sie im Repository-Verzeichnis eine stille Validierung der Compose-Konfiguration durch, sodass die erweiterten Secrets nicht ausgegeben werden, und starten Sie anschließend die Dienste. Die stille Validierung prüft das Compose-Modell; sie garantiert nicht, dass die Container starten. Docker dokumentiert diese Option in seiner Compose-Konfigurationsreferenz .

docker compose -f docker-compose.enterprise.yml config --quiet
docker compose -f docker-compose.enterprise.yml up -d

Der erste Start kann länger dauern, da Images erstellt oder heruntergeladen und Abhängigkeiten initialisiert werden. Falls die Konfigurationsprüfung eine nicht gesetzte Variable meldet, überprüfen Sie Ihre .envKonfigurationsdatei und die Variablennamen in der Compose-Datei. Setzen Sie Geheimnisse nur dann in Anführungszeichen, wenn diese Bestandteil des beabsichtigten Werts sind.

5. Überprüfen Sie die Bereitschaft, bevor Sie Ihre Plattform verbinden.

Prüfen Sie die Leistungen und den Gesundheitszustand:

docker compose -f docker-compose.enterprise.yml ps

Warten Sie, bis die Integritätsprüfung des Dokumentenservers erfolgreich war. Die offizielle Compose-Datei führt diese Prüfung http://localhost:8000/info/info.jsoninnerhalb des Containers durch und benötigt dafür 60 Sekunden. Sollte der Dienst weiterhin fehlerhaft sein, überprüfen Sie die Protokolle und den Status der Abhängigkeiten.

docker compose -f docker-compose.enterprise.yml logs --tail=100 onlyoffice-documentserver

Öffnen Sie anschließend die Anwendung http://localhostauf dem Host oder die zugeordnete URL in einem Browser, der den Server erreichen kann. Die Compose-Anleitung von ONLYOFFICE verwendet die Willkommensseite als ersten Installationstest. Für den produktiven Einsatz im Remote-Bereich sollten Sie den Dienst über HTTPS auf Ihrer Domain bereitstellen, anstatt den Datenverkehr des Editors über unverschlüsseltes HTTP zu leiten. Informationen zur Konfiguration des Netzwerkzugriffs und von TLS finden Sie im Leitfaden für Enterprise-Docker-Ports und im Docker-Installationsleitfaden .

Konfigurieren Sie abschließend die URL des Dokumentenservers Ihrer Plattform und das zugehörige JWT-Geheimnis. Öffnen, bearbeiten und speichern Sie anschließend ein Testdokument über diese Integration. Die Willkommensseite allein beweist nicht, dass Connector, Reverse-Proxy, JWT oder Callback-URL korrekt konfiguriert sind. Falls die Dienste einwandfrei funktionieren, der Editor sich aber nicht von der Plattform aus öffnen lässt, prüfen Sie, ob die Plattform die Docs-URL erreichen kann und ob beide Seiten dasselbe JWT-Geheimnis und denselben Header verwenden. Bei einer Bereitstellung mit mehreren Hosts oder Hochverfügbarkeit sollten Sie diesen Compose-Stack als Ausgangspunkt betrachten und die Bereitstellungshinweise von ONLYOFFICE beachten, anstatt davon auszugehen, dass ein Compose-Host Clustering bereitstellt.