🚀 OpenCloud + Collabora in einem Rutsch installieren

Die neue modulare Installationsmethode mit .env‑Includes

Die neue Installationsmethode von OpenCloud macht etwas möglich, das früher nur mit viel Handarbeit ging:
Ein vollständiges Setup aus OpenCloud, Collabora und WOPI – in einem einzigen docker compose up -d.

Der Trick dahinter ist genial einfach:
OpenCloud lädt zusätzliche Dienste automatisch per Include‑Mechanismus, der über eine .env‑Variable gesteuert wird. Dadurch können Collabora und WOPI „hineingemischt“ werden, ohne dass man selbst Compose‑Dateien zusammenkopieren muss.

In diesem Artikel zeige ich dir, wie du das komplette System in einem Durchgang installierst – inklusive DNS‑Challenge, Zertifikaten und NGINX‑Konfiguration.

🧩 Architekturüberblick

Für ein vollständiges Setup benötigst du drei Domains:

Alle drei Dienste laufen in Docker‑Containern und werden über NGINX reverse‑proxied.
Zertifikate werden per DNS‑Challenge (z. B. Cloudflare) erzeugt.

🛠️ Vorbereitung: .env minimal konfigurieren

Die neue Installationsmethode erlaubt es, zusätzliche Dienste einfach über eine Variable zu aktivieren:

OPENCOCLOUD_INCLUDE=collabora,wopi

Damit weiß OpenCloud:

„Bitte die Collabora‑ und WOPI‑Compose‑Snippets automatisch einbinden.“

Zusätzlich brauchst du nur wenige weitere Variablen:

DOMAIN_OC=oc.example.org
DOMAIN_COLLAB=collab.example.org
DOMAIN_WOPI=wopi.example.org

CF_API_TOKEN=dein-cloudflare-token
[email protected]

Das war’s.
Keine 20‑seitigen Compose‑Dateien mehr. Keine Copy‑Paste‑Orgie.

🔐 DNS‑Challenge & Zertifikate

Die neue Installer‑Routine übernimmt die Zertifikatsgenerierung automatisch, sobald:

• die Domains existieren
• der DNS‑Provider korrekt konfiguriert ist
• ein gültiger API‑Token gesetzt wurde

Der Installer erzeugt:

• ein Zertifikat für oc.example.org
• ein Zertifikat für collab.example.org
• ein Zertifikat für wopi.example.org

Alles vollautomatisch per DNS‑Challenge, wobei natürlich 1 Zertifikat oc.example.org für alle drei Domains ausreicht.

🌐 NGINX‑Konfiguration

Auch die NGINX‑Konfiguration wird automatisch generiert.
Du musst nichts mehr manuell anpassen.

Der Installer erzeugt:

• Reverse‑Proxy für OpenCloud
• Reverse‑Proxy für Collabora
• Reverse‑Proxy für WOPI
• TLS‑Konfiguration
• Weiterleitungen
• Security‑Header

Die Zeiten, in denen man Collabora‑Header oder WOPI‑Rewrite‑Regeln selbst schreiben musste, sind vorbei.

⚠️ Wichtige Besonderheit: Startreihenfolge

Das ist der einzige Punkt, der wirklich kritisch ist:

Collabora und WOPI müssen laufen, bevor OpenCloud startet.

Warum?

• OpenCloud prüft beim Start, ob Office‑Integration verfügbar ist
• Wenn Collabora oder WOPI fehlen, deaktiviert OpenCloud die Office‑Funktionen
• Ein späteres Aktivieren ist möglich, aber fehleranfällig

Die neue Installationsmethode berücksichtigt das bereits:

1. Collabora wird gestartet
2. WOPI wird gestartet
3. Erst dann startet OpenCloud

Wenn du alles in einem Rutsch startest, ist die Reihenfolge automatisch korrekt.

🚀 Installation in einem einzigen Befehl

Wenn deine .env steht, reicht ein einziger Befehl:

docker compose up -d

Der Installer:

1. lädt die Includes
2. startet Collabora
3. startet WOPI
4. startet OpenCloud
5. erzeugt Zertifikate
6. generiert NGINX‑Konfiguration
7. aktiviert Office‑Integration

Nach wenigen Minuten läuft dein komplettes System.

🎉 Fazit

Die neue Installationsmethode von OpenCloud ist ein echter Game‑Changer:

• Modular durch Includes
• Minimaler Aufwand dank .env
• Automatische Zertifikate per DNS‑Challenge
• Automatische NGINX‑Konfiguration
• Korrekte Startreihenfolge für Office‑Integration
• Ein einziger Befehl für das komplette Setup

Wer früher Stunden mit Collabora‑Konfiguration, WOPI‑Proxy‑Regeln und Zertifikaten verbracht hat, wird diese neue Methode lieben.