Überarbeitet am 8. September 2026.
Diese Anleitung ist einer der Artikel, bei denen das Alter besonders deutlich geworden ist. Meine ursprüngliche Version brauchte noch einen speziellen Ubuntu-16.04-Kernel und hantierte mit AUFS. Das ist heute Geschichte. Nextcloud Office basiert weiterhin auf Collabora Online beziehungsweise CODE, lässt sich aber inzwischen wesentlich entspannter einrichten.
Für kleine private Installationen gibt es sogar einen eingebauten CODE-Server. Wer etwas mehr Leistung möchte, betreibt Collabora separat – zum Beispiel als Docker-Container hinter einem Reverse Proxy. Genau diesen Weg zeige ich hier.
Falls Docker auf deinem Server noch fehlt, findest du hier meine aktualisierte Anleitung: Docker und Docker Compose unter Debian und Ubuntu installieren.
Was ist Nextcloud Office eigentlich?
Nextcloud Office ist die Office-Integration innerhalb von Nextcloud. Die eigentliche Bearbeitung übernimmt Collabora Online. Damit lassen sich unter anderem DOCX-, XLSX-, PPTX- und OpenDocument-Dateien direkt im Browser öffnen und gemeinsam bearbeiten.
Wenn du erstmal nur ausprobieren möchtest, ob dir das gefällt, reicht für eine kleine Installation oft der Built-in CODE Server. Er lässt sich als Nextcloud-App installieren und funktioniert in vielen Setups ohne zusätzlichen Container. Nextcloud weist allerdings selbst darauf hin, dass ein separater Collabora-Server für bessere Performance sinnvoller ist.
1. Eigene Subdomain für Collabora vorbereiten
Für einen separaten Collabora-Server würde ich eine eigene Subdomain verwenden, zum Beispiel:
office.example.de
Die Subdomain zeigt auf deinen Server und bekommt ein gültiges TLS-Zertifikat. Auch deine Nextcloud sollte natürlich über HTTPS erreichbar sein. Nextcloud und Collabora sollten dasselbe Protokoll verwenden – praktisch also beide HTTPS.
Mehr zu den grundlegenden Sicherheitsmaßnahmen findest du in Nextcloud richtig absichern.
2. Collabora CODE als Docker-Container starten
Das offizielle CODE-Image heißt weiterhin collabora/code. Zuerst laden wir es:
docker pull collabora/code
Danach starten wir Collabora nur auf localhost. So ist Port 9980 nicht direkt aus dem Internet erreichbar:
docker run -t -d \
-p 127.0.0.1:9980:9980 \
-e 'aliasgroup1=https://cloud.example.de:443' \
--restart always \
--cap-add MKNOD \
--name collabora \
collabora/code
cloud.example.de ersetzt du durch die Domain deiner Nextcloud. Der Container lauscht anschließend nur auf 127.0.0.1:9980. Von außen kommt man später ausschließlich über den Reverse Proxy an Collabora heran.
3. Reverse Proxy vor Collabora setzen
Collabora benötigt einen Reverse Proxy, der die öffentliche Adresse https://office.example.de auf den lokalen Dienst an Port 9980 weiterleitet. Anders als in sehr alten Anleitungen heißen die wichtigen Pfade heute unter anderem:
/browser/hosting/discovery/hosting/capabilities/cool- WebSocket-Verbindungen unter
/cool/.../ws
Wer noch eine alte Konfiguration mit /lool und /loleaflet hat, sollte sie deshalb überprüfen. Die aktuellen Collabora-Komponenten verwenden coolwsd, /cool und /browser.
Da ich selbst Nginx nutze, würde ich dafür die aktuelle Reverse-Proxy-Vorlage von Collabora beziehungsweise Nextcloud als Ausgangspunkt nehmen. Besonders wichtig ist, dass die WebSocket-Verbindung mit durchgereicht wird. Eine reine normale HTTP-Weiterleitung reicht nicht.
4. Erst Collabora testen
Bevor ich Nextcloud konfiguriere, teste ich den Office-Server separat. Diese beiden Adressen sollten über den Browser erreichbar sein:
https://office.example.de/hosting/capabilities
https://office.example.de/hosting/discovery
Auch direkt vom Nextcloud-Server aus kann man testen:
curl https://office.example.de/hosting/capabilities
curl https://office.example.de/hosting/discovery
Wenn das schon nicht funktioniert, braucht man in Nextcloud noch gar nicht weiterzusuchen. Dann liegt das Problem eher bei DNS, Zertifikat, Firewall oder Reverse Proxy.
5. Nextcloud Office installieren und verbinden
In Nextcloud gehst du zu Apps → Office & Text und installierst beziehungsweise aktivierst Nextcloud Office.
Anschließend findest du unter Administrationseinstellungen → Office die Verbindung zum Collabora-Server. Dort trägst du ein:
https://office.example.de
Wenn alles stimmt, sollte Nextcloud die Verbindung erkennen. Danach kannst du direkt eine neue Textdatei oder Tabelle erstellen und testen.
6. WOPI-Zugriffe einschränken
Ein Punkt, den es in meiner alten Anleitung noch gar nicht gab: Nextcloud empfiehlt ausdrücklich, WOPI-Anfragen auf die erwarteten Collabora-Server zu begrenzen. Die entsprechende Allow-Liste findest du in den Office-Administrationseinstellungen.
Dort sollte möglichst nur die IP beziehungsweise das Netz eingetragen werden, aus dem dein Collabora-Server Nextcloud tatsächlich erreicht. Das verhindert, dass beliebige andere Systeme WOPI-Anfragen an deine Nextcloud stellen können.
7. Typische Fehler
Wenn Nextcloud Office nicht verbindet, prüfe ich in dieser Reihenfolge:
- Kann der Browser Nextcloud und Collabora über HTTPS erreichen?
- Kann Nextcloud
office.example.deerreichen? - Kann Collabora wiederum die Nextcloud-Domain erreichen?
- Ist das TLS-Zertifikat gültig?
- Werden die
/cool-WebSockets vom Reverse Proxy korrekt weitergeleitet? - Ist die WOPI-Allow-Liste korrekt?
Für den Container selbst helfen die Logs:
docker logs --tail 100 collabora
Die Nextcloud-Logs sollte man parallel ebenfalls ansehen. Sehr häufig ist es kein Office-Fehler, sondern schlicht eine nicht funktionierende Verbindung in eine der beiden Richtungen.
8. Collabora aktualisieren
Da CODE regelmäßig aktualisiert wird, sollte auch der Container nicht jahrelang unangetastet bleiben:
docker pull collabora/code
Anschließend wird der Container mit demselben Startbefehl neu erstellt. Wer stattdessen Docker Compose verwendet, kann das entsprechend mit docker compose pull und docker compose up -d erledigen.
Mein Fazit nach der Überarbeitung
Der Unterschied zu meiner ersten Collabora-Anleitung ist schon ziemlich absurd: Kein Xenial-Proposed, kein Kernel 4.4, kein AUFS-Gefrickel mehr. Für kleine Instanzen reicht heute sogar der eingebaute CODE-Server. Wer es etwas sauberer und performanter möchte, stellt einen separaten Collabora-Container hinter eine eigene HTTPS-Subdomain.
Wenn du noch am Anfang mit Nextcloud bist, findest du in Was bietet Nextcloud 2026? einen Überblick darüber, was die Cloud inzwischen alles kann.
Weiterführend: Nextcloud Office installieren, Collabora per Docker und Troubleshooting.
Gedanken dazu 0 Kommentare
Noch ist es ruhig hier. Dein Gedanke könnte der erste sein.
Was denkst du dazu?
Dein Kommentar erscheint nach der Freigabe.