Technical Anshu
Tutorials Blog
📄 OnlyOffice + Nextcloud-Setup

Installieren Sie OnlyOffice Document Server und verbinden Sie ihn mit Nextcloud

Ihre Nextcloud speichert die Dateien, kann Dokumente jedoch nicht ordnungsgemäß bearbeiten. Der OnlyOffice Document Server ist die fehlende Bearbeitungs-Engine – hier ist die vollständige Docker-Installation plus das Connector-Setup, das die beiden verbindet, mit dem einen Fehler beim geheimen Schlüssel, der die meisten ersten Versuche scheitert.

✍️ Technical Anshu🐧 Linux Server + Docker⏱️ One sitting setup
🎥 Sehen Sie sich den vollständigen Installations- und Integrationsprozess im Video oben Schritt für Schritt an

Nextcloud allein bietet Ihnen Speicherung und Freigabe, aber zum Öffnen einer darin enthaltenen Word- oder Excel-Datei ist ein echter Editor erforderlich. Dieser Editor ist der OnlyOffice Document Server – ein zweiter Dienst, den Sie selbst hosten und mit dem Nextcloud über eine kleine Connector-App kommuniziert. Diese Anleitung beschreibt den genauen Weg aus dem Video: Installieren Sie den Document Server mit Docker und verbinden Sie ihn dann mit Nextcloud. Eine ehrliche Warnung, bevor wir beginnen: Der Document Server ist ein Schwergewichtsdienst und kein kleines Plugin. Geben Sie ihm einen richtigen Server und eine eigene Adresse, und der Rest dieser Seite funktioniert reibungslos.

Nextcloud — Settings — ONLYOFFICE (connector app)
Document Server addresshttps://office.example.com
Secret keymust match JWT_SECRET on the server
Connection check on SaveOK
Editor opens inside NextcloudDocs, Sheets, Slides
Das Connector-Einstellungsfeld in Nextcloud – illustrative Werte als Beispiel.
1

Verstehen Sie zuerst die beiden Teile

In diesem Setup gibt es zwei separate Server, und die größte Verwirrung entsteht durch ihre Verwechslung. Nextcloud speichert Ihre Dateien, Benutzer und Freigaben – es bearbeitet nie ein Dokument selbst. Der OnlyOffice Document Server (auch OnlyOffice Docs genannt) ist die Bearbeitungsmaschine – er rendert den Dokumenteditor im Browser, wendet jeden Tastendruck an und sendet die fertige Datei zum Speichern an Nextcloud zurück.

Die Connector-App in Nextcloud ist die Brücke zwischen ihnen. Es teilt Nextcloud mit, wo sich der Dokumentenserver befindet, und beweist mit einem gemeinsamen geheimen Schlüssel, dass die beiden Server miteinander kommunizieren dürfen. Wenn ein Benutzer auf eine Word- oder Excel-Datei klickt, lädt der Editor tatsächlich vom Dokumentenserver, während die Datei in Nextcloud gespeichert bleibt.

2

Geben Sie dem Dokumentenserver eine eigene Adresse

Der Document Server benötigt eine eigene Subdomäne oder Serveradresse, zum Beispiel office.example.com, getrennt von Ihrer Nextcloud-Adresse wie cloud.example.com. Erstellen Sie zuerst den DNS-Eintrag und lassen Sie ihn auf den Computer verweisen, auf dem OnlyOffice ausgeführt wird. Beim Versuch, beide Dienste unter einer Adresse mit Pfaden zu verstecken, bleiben die meisten Erstinstallationen stecken. Halten Sie es also einfach: ein Name für Nextcloud, ein Name für den Document Server.

3

Installieren Sie den Document Server mit Docker

Die im Video gezeigte Route ist die Docker-Installation auf einem Linux-Server, die auch offiziell von OnlyOffice dokumentiert wird. Ein Befehl startet alles:

  1. Stellen Sie sicher, dass Docker auf dem Server installiert ist und ausgeführt wird
  2. Wählen Sie ein langes, zufälliges Geheimnis – dieses wird zum gemeinsamen Schlüssel zwischen den beiden Servern
  3. Führen Sie den Container explizit mit Ihrem geheimen Satz aus:

sudo docker run -i -t -d -p 80:80 --restart=always -e JWT_SECRET=your-own-secret-here -v /app/onlyoffice/logs:/var/log/onlyoffice -v /app/onlyoffice/data:/var/www/onlyoffice/Data -v /app/onlyoffice/lib:/var/lib/onlyoffice onlyoffice/documentserver

Das Festlegen von JWT_SECRET selbst ist keine optionale Dekoration. Wenn Sie es überspringen, generiert der Container ein zufälliges Geheimnis – und seit Version 7.2 wird dieses Geheimnis bei jedem Neustart neu generiert, wodurch die Nextcloud-Verbindung nach dem ersten Neustart stillschweigend unterbrochen wird. Die drei -v-Volume-Mounts halten Protokolle, Zertifikate und Cache außerhalb des Containers, sodass sie durch ein Update nicht gelöscht werden.

4

Überprüfen Sie, ob der Document Server aktiv ist

Geben Sie dem Container ein paar Minuten Zeit, um zu starten, und öffnen Sie dann http://office.example.com in einem Browser. Sie sollten die Begrüßungsseite von OnlyOffice Docs sehen, die bestätigt, dass die Dienste ausgeführt werden. Sie können den Server auch mit sudo docker ps überprüfen – der Container onlyoffice/documentserver sollte als aktiv aufgeführt sein. Wechseln Sie nicht zu Nextcloud, bis diese Seite geladen ist. Das Verbinden eines toten Servers führt später nur zu verwirrenden Fehlern.

5

Installieren Sie die Connector-App in Nextcloud

Wechseln Sie nun zu Nextcloud. Melden Sie sich als Administrator an, öffnen Sie den Abschnitt Apps, suchen Sie nach ONLYOFFICE und installieren und aktivieren Sie die offizielle Connector-App. Diese App ist kostenlos und wird im Nextcloud App Store veröffentlicht – es muss nichts manuell hochgeladen werden.

6

Geben Sie die Adresse und den Geheimschlüssel ein

Öffnen Sie Einstellungen → ONLYOFFICE in Nextcloud und geben Sie zwei Dinge ein:

  1. Document Server-Adresse – die Adresse aus Schritt 2, zum Beispiel https://office.example.com
  2. Geheimer Schlüssel – genau der gleiche Wert, den Sie beim Starten des Containers als JWT_SECRET übergeben haben. Ein Zeichen anders und die Verbindung wird abgelehnt
  3. Klicken Sie auf Speichern – der Connector testet sofort die Verbindung und meldet, ob sie erfolgreich war

Wenn das Speichern erfolgreich ist, ist die Integration live. Wenn dies fehlschlägt, erfahren Sie in der Fehlermeldung, welche Seite untersucht werden muss – ein Adressproblem oder eine geheime Nichtübereinstimmung (für den JWT-Fehler gibt es eine eigene detaillierte Anleitung, die auf unseren Fallseiten verlinkt ist).

7

Öffnen Sie ein Dokument und testen Sie eine echte Bearbeitung

Schließen Sie mit einem echten Test ab, nicht nur mit einem grünen Häkchen. Laden Sie eine Word- oder Excel-Datei auf Nextcloud hoch, klicken Sie darauf und bestätigen Sie, dass sich der OnlyOffice-Editor öffnet. Geben Sie etwas ein, schließen Sie das Dokument, warten Sie einige Sekunden, bis der Speichervorgang abgeschlossen ist, und laden Sie die Datei herunter, um zu überprüfen, ob Ihre Bearbeitung darin enthalten ist. Versuchen Sie auch, dasselbe Dokument in einem zweiten Browserprofil zu öffnen – bei der gemeinsamen Bearbeitung sollten beide Cursor angezeigt werden. Wenn das alles klappt, ist Ihr selbstgehostetes Büro bereit für das Team.

🔴 Die gesamte Integration basiert auf einem Geheimnis. Der JWT_SECRET im Docker-Befehl und der geheime Schlüssel in den Nextcloud-Connector-Einstellungen müssen Zeichen für Zeichen identisch sein. Nichtübereinstimmung ist der Hauptgrund dafür, dass eine Neuinstallation die Verbindung verweigert – und wenn Sie den Container ein zufälliges Geheimnis generieren lassen, anstatt Ihr eigenes festzulegen, wird die Verbindung beim nächsten Serverneustart von selbst unterbrochen.

🎥 Sehen Sie sich die komplette Einrichtung im Video an

Die vollständige OnlyOffice Document Server-Installation und Nextcloud-Integration, Schritt für Schritt live gezeigt.

▶️ Watch Full Video
❓ Häufige Fragen (FAQ)

Kann der OnlyOffice Document Server kostenlos selbst gehostet werden?

Die Community Edition von OnlyOffice Docs und die Nextcloud-Connector-App können kostenlos installiert und verwendet werden. Die kostenlose Edition ist für kleine Teams konzipiert und weist im Vergleich zu den kostenpflichtigen Enterprise-Editionen Einschränkungen auf. Sehen Sie sich die Seite mit den aktuellen Einschränkungen Ihrer Version an, bevor Sie eine große Einführung planen.

Können OnlyOffice und Nextcloud auf demselben Server laufen?

Ja, viele kleine Setups laufen sowohl auf einem Rechner, mit dem Document Server in Docker und einer eigenen Subdomain. Denken Sie daran, dass der Document Server ressourcenintensiv ist: Der Computer benötigt für beide Dienste ausreichend RAM und CPU, sonst wird sich die Bearbeitung für alle langsam anfühlen.

Warum fragt der Connector nach einem geheimen Schlüssel?

Das Geheimnis signiert die Anfragen zwischen Nextcloud und dem Document Server (JWT), sodass eine zufällige Website Ihren Document Server nicht zum Öffnen oder Konvertieren von Dateien auffordern kann. Beide Seiten müssen das gleiche Geheimnis bewahren – dieser gemeinsame Wert ist der Beweis dafür, dass die beiden Server einander vertrauen.

Diese Anleitung basiert auf dem technischen Anshu-Video zur Installation von OnlyOffice Document Server mit Nextcloud. • Sie stecken bei einem Schritt fest? Fragen Sie in den Videokommentaren nach – dort erhalten Sie eine Antwort 🙏