Startklar in 3 Schritten

Wir beschreiben, wie Sie Collabora Online auf Ihrem Server installieren und mit dem Docker Image in Ihre Nextcloud integrieren.

Anforderungen

Für die Installation ist Folgendes erforderlich:

1. Ein Host, der einen Docker Container ausführen kann
2. Eine Subdomain oder zweite Domain, auf welcher der Collabora Online Server laufen kann
3. Ein Apache Server mit einigen aktivierten Modulen (NGNIX Anleitungen hier im Blog)
4. Ein gültiges SSL-Zertifikat für die Domain, auf der Collabora Online laufen soll
5. Ein gültiges SSL-Zertifikat für Ihre Nextcloud

Hinweis: Diese Anleitung beeinhaltet KEINE selbst-signierten Zertifikate. Wenn Sie selbstsignierte Zertifikate verwenden, sind Sie hauptsächlich auf sich alleine gestellt ;-)

1. Installieren Sie den Collabora Online Server

Mit den folgenden Schritten installieren Sie den Collabora Online Docker - bitte achten Sie darauf "cloud.nextcloud.com" mit dem Host zu ersetzen, auf welchem Ihre Nextcloud läuft. Stellen Sie außerdem sicher, dass alle Punkte mit doppelten Backslashes (umgekehrten Schrägstrichen) entfernt werden (\), da diese Zeichenfolge als regulärer Ausdruck gewertet wird (und Ihr Bash den ersten Backslash entfernt). Wenn Sie den Docker Container mit mehr als einer Nextcloud nutzen wollen, müssen Sie stattdessen 'domain=cloud\\.nextcloud\\.com\|second\\.nextcloud\\.com' (Alle Domains werden durch \| getrennt.)

                docker pull collabora/code
                docker run -t -d -p 127.0.0.1:9980:9980 -e 'domain=cloud\\.nextcloud\\.com' --restart always --cap-add MKNOD collabora/code
			

Optional können Sie die gewünschten Wörterbücher wie folgt auswählen:

                docker run -t -d -p 127.0.0.1:9980:9980 -e 'domain=cloud\\.nextcloud\\.com' -e 'dictionaries=de en es ..' --restart always --cap-add MKNOD collabora/code
            

So sind Sie nicht nur auf Deutsch, Englisch, Italienisch, Französisch und Spanisch beschränkt.

Sobald Sie dies erledigt naben, ist Ihr Server unter "localhost:9980" erreichbar. Jetzt muss nur noch das lokal installierte Apache Reverse Proxy konfiguriert werden.

2. Installieren Sie Apache Reverse Proxy

Unter neuesten Ubuntu oder Debian Versionen sollte es so funktionieren:

1. apt-get install apache2
2. a2enmod proxy
3. a2enmod proxy_wstunnel
4. a2enmod proxy_http
5. a2enmod ssl

Achtung, wenn Sie Nextcloud 23 (Nextcloud HUB II) verwenden, hat sich die VirtualHost-Konfiguration geändert. Die neuesten Installationsinformationen finden Sie in der offiziellen Dokumentation zu Collabora Online

Anschließend vervollständigen Sie die Konfiguration eines VirtualHosts. Aus Sicherheitsgründen empfehlen wir, eine Subdomain wie z. B. office.nextcloud.com statt derselben Domain zu benutzen. Nachfolgend finden Sie eine Beispielkonfiguration:

				
<VirtualHost *:443>
ServerName office.nextcloud.com:443

# SSL configuration, you may want to take the easy route instead and use Lets Encrypt!
SSLEngine on
SSLCertificateFile /path/to/signed_certificate
SSLCertificateChainFile /path/to/intermediate_certificate
SSLCertificateKeyFile /path/to/private/key
SSLProtocol             all -SSLv2 -SSLv3
SSLCipherSuite ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES128-SHA:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA:ECDHE-RSA-AES256-SHA:DHE-RSA-AES128-SHA256:DHE-RSA-AES128-SHA:DHE-RSA-AES256-SHA256:DHE-RSA-AES256-SHA:ECDHE-ECDSA-DES-CBC3-SHA:ECDHE-RSA-DES-CBC3-SHA:EDH-RSA-DES-CBC3-SHA:AES128-GCM-SHA256:AES256-GCM-SHA384:AES128-SHA256:AES256-SHA256:AES128-SHA:AES256-SHA:DES-CBC3-SHA:!DSS
SSLHonorCipherOrder     on

# Encoded slashes need to be allowed
AllowEncodedSlashes NoDecode

# Container uses a unique non-signed certificate
SSLProxyEngine On
SSLProxyVerify None
SSLProxyCheckPeerCN Off
SSLProxyCheckPeerName Off

# keep the host
ProxyPreserveHost On

# static html, js, images, etc. served from loolwsd
# loleaflet is the client part of LibreOffice Online
ProxyPass           /loleaflet https://127.0.0.1:9980/loleaflet retry=0
ProxyPassReverse    /loleaflet https://127.0.0.1:9980/loleaflet

# WOPI discovery URL
ProxyPass           /hosting/discovery https://127.0.0.1:9980/hosting/discovery retry=0
ProxyPassReverse    /hosting/discovery https://127.0.0.1:9980/hosting/discovery

# Main websocket
ProxyPassMatch "/lool/(.*)/ws$" wss://127.0.0.1:9980/lool/$1/ws nocanon

# Admin Console websocket
ProxyPass   /lool/adminws wss://127.0.0.1:9980/lool/adminws

# Download as, Fullscreen presentation and Image upload operations
ProxyPass           /lool https://127.0.0.1:9980/lool
ProxyPassReverse    /lool https://127.0.0.1:9980/lool

# Endpoint with information about availability of various features
ProxyPass           /hosting/capabilities https://127.0.0.1:9980/hosting/capabilities retry=0
ProxyPassReverse    /hosting/capabilities https://127.0.0.1:9980/hosting/capabilities
</VirtualHost>
			

Nach der Konfiguration starten Sie den Apache neu über /etc/init.d/apache2 restart.

3. Konfigurieren Sie die App in Nextcloud

1. Gehen Sie zur Apps-Sektion und wählen Sie "Office & Text"
2. Installieren Sie die "Collabora Online" App
3. Admin -> Collabora Online -> Wählen Sie den Server aus, den Sie zuvor aufgesetzt haben (z. B. "https://office.nextcloud.com")

Glückwunsch, Collabora Online ist nun in Ihre Nextcloud integriert!

---

Updates installieren

Gelegentlich werden neue Versionen des Docker Images mit Sicherheits- und Funktionsupdates veröffentlicht. Wir werden Dich dann natürlich benachrichtigen! So funktioniert ein Upgrade auf eine neue Version:

• Holen Sie sich das neue Docker Image:
  docker pull collabora/code
• Auflisten der Docker Images:
  docker ps
  Dem Output können Sie die Container ID Ihres Collabora Online Docker Images entnehmen.
• Anhalten und das Collabora Online Docker Image entfernen:
  docker stop CONTAINER_ID
docker rm CONTAINER_ID
• Ein neues Image starten:
  docker run -t -d -p 127.0.0.1:9980:9980 -e 'domain=cloud\\.nextcloud\\.com' --restart always --cap-add MKNOD collabora/code

Viel Spaß!

---

Fehlerbehebung

Häufig auftretende Probleme:

• Problem: Ich kann die URL im Admin-Panel nicht konfigurieren.
  Höchstwahrscheinlich ist das verursacht durch die aktivierte "Documents" App. Nach Deaktivierung der App können Sie die URL setzen.
• Problem: Ich erhalte Verbindungsfehler, wenn ich versuche, Dokumente zu öffnen.
  Überprüfen das Fehlerprotokoll von Docker (docker logs id-of-your-instance). Wenn das Log etwas Ähnliches wie das hier anzeigt:
  No acceptable WOPI hosts found matching the target host [YOUR NEXTCLOUD DOMAIN] in config.
Unauthorized WOPI host. Please try again later and report to your administrator if the issue persists.
  haben Sie möglicherweise den Docker Container mit der falschen URL gestartet. Stellen Sie sicher, dass Sie mit der URL Ihres Nextcloud Servers starten, nicht mit dem Server, auf welchem Collabora Online läuft.
• Problem: Connection is not allowed Fehlermeldungen
  Es ist möglich, dass Ihre Firewall Verbindungen blockiert. Versuchen Sie, Docker erst nach Ihrer Firewall zu starten, da Änderungen an Ihren IP Tables gemacht werden, um Collabora Online funktionsfähig zu machen.
• Issue: We are sorry, this is an unexpected connection error. Please try again. Fehlermeldung
  Die Collabora Online App funktioniert im Moment nicht, wenn Sie sie nur für bestimmte Gruppen aktivieren. Entfernen Sie den Gruppen-Filter in der "App" Sektion.
• Problem: Collabora Online Developer Edition kommt mit meinen 100 Benutzern nicht zurecht.
  Dieses Docker-Image ist für den Heimgebrauch konzipiert. Wenn Sie eine skalierbarere Lösung benötigen, sollten Sie ein Support-Abonnement für ein zuverlässiges Online-Office-Erlebnis.
• Issue: Collabora Online funktioniert nicht mit Verschlüsselung.
  Korrekt, das wird momentan nicht unterstützt.

Mehr Fragen und Antworten finden Sie in unserem Beitrag im Forum - eröffnen Sie einen neuen Thread, wenn Sie noch weitere Fragen haben.