, , , ,

Euro-Office mit Docker installieren & Nextcloud verbinden (2026)

•

min Lesezeit

•

Letzte Änderung

Euro-Office mit Docker installieren: Du betreibst den Document Server in einem Container, bindest ihn über eine eigene HTTPS-Domain an Nextcloud an und überprüfst die Verbindung samt JWT-Sicherheit.

Das Ergebnis: Du kannst ein Dokument aus Nextcloud im Browser öffnen und bearbeiten. Beachte, dass die frei verfügbaren Euro-Office-Community-Builds laut Projekt zum Testen und Mitwirken vorgesehen sind; für produktive Anforderungen muss der Support- und Releaseweg gesondert bewertet werden.

Stand: 3. November 2026. Die Befehle sind für einen neuen, isolierten Server oder eine VM gedacht. Euro-Office ist kein eigenständiger Dateispeicher, sondern ein Dokumentenserver für eine kompatible Plattform wie Nextcloud. Die Euro-Office-Community-Builds sind laut Projekt vor allem für Tests, Self-Hosting und Entwicklung bestimmt; für regulierte oder besonders kritische Produktivsysteme muss die Support- und Build-Variante sorgfältig geprüft werden.

Was ist Euro-Office – und was brauche ich dafür?

Euro-Office stellt Editoren für Dokumente, Tabellen und Präsentationen bereit. Die Dateien liegen üblicherweise weiterhin in Nextcloud. Nextcloud startet die Bearbeitung, der Euro-Office Document Server rendert und bearbeitet den Inhalt. Die offizielle Integration setzt Nextcloud 34 oder neuer voraus.

Beispiel eines Dokumenteneditors in Nextcloud Office mit Formatierungsfunktionen und Dokumentinhalten

Illustration der Office-Oberfläche aus dem Nextcloud-Projekt. Sie zeigt keine individuelle Serverkonfiguration.

1. Voraussetzungen und Zielarchitektur

  • Docker Engine ab 20.10, Docker Compose Plugin, laut Projekt mindestens 4 GB RAM und rund 5 GB freier Speicherplatz.
  • Eine erreichbare Nextcloud-Installation ab Version 34 mit Installationsberechtigung für Apps.
  • Eine eigene HTTPS-Subdomain, beispielsweise office.example.com, und ein vorhandener Reverse Proxy wie Pangolin, Coolify-Traefik oder Nginx.
  • Der Dokumentenserver muss von Nextcloud erreichbar sein; je nach Integration sind auch Rückverbindungen zum Nextcloud-Host erforderlich.
  • Sichere Ordner oder Volumes für Daten, Laufzeitinformationen und Logs sowie ein zufällig generierter JWT-Schlüssel.

Portkonflikt vermeiden: Im Originalentwurf wurde -p 80:80 verwendet. Auf vielen Homeservern ist Port 80 schon durch Pangolin, Coolify oder Apache belegt. Die folgende Beispielkonfiguration bindet den Dokumentenserver deshalb nur auf 127.0.0.1:8088. Läuft dein Reverse Proxy auf einem anderen Host, musst du eine passende private Netzverbindung statt localhost verwenden.

2. Sichere Verzeichnisse und JWT-Schlüssel vorbereiten

sudo mkdir -p /opt/eurooffice/{data,private,logs}
sudo mkdir -p /opt/eurooffice
cd /opt/eurooffice
openssl rand -hex 32

Kopiere die Ausgabe des letzten Befehls in die lokale .env-Datei. Dieser JWT-Schlüssel muss später exakt mit dem Schlüssel in der Nextcloud-Integration übereinstimmen. Er gehört nicht in Screenshots, Git-Repositories oder öffentliche Forenbeiträge.

Öffne die Umgebungsdatei mit deinem Editor:

sudo nano /opt/eurooffice/.env

Schreibe nur diese Zuweisung in die Datei. Den Platzhalter ersetzt du mit dem zuvor erzeugten geheimen Hex-Wert; er muss in der Nextcloud-Integration exakt gleich sein:

EURO_JWT_SECRET=HIER_DEINEN_ZUFAELLIGEN_SCHLUESSEL_EINTRAGEN

Speichere die Datei, schließe den Editor und schränke anschließend ihren Zugriff ein:

sudo chmod 600 /opt/eurooffice/.env

3. Euro-Office mit Docker Compose starten

Verwende die von der offiziellen Dokumentation vorgesehenen Pfade für persistente Daten. Besonders wichtig ist /var/www/euro-office/Data: Dort liegen unter anderem runtime.json, eventuell automatisch erzeugte Geheimnisse sowie bei WOPI-Betrieb Schlüsseldateien. Fehlt dieses Volume, kann nach einem Container-Neustart die Verbindung zur Office-Anwendung ausfallen.

services:
  eurooffice:
    image: ghcr.io/euro-office/documentserver:latest
    container_name: euro-office
    restart: unless-stopped
    ports:
      - "127.0.0.1:8088:80"
    environment:
      JWT_ENABLED: "true"
      JWT_SECRET: "${EURO_JWT_SECRET}"
      EXAMPLE_ENABLED: "false"
    volumes:
      - ./data:/var/lib/euro-office/documentserver
      - ./private:/var/www/euro-office/Data
      - ./logs:/var/log/euro-office/documentserver

Speichere diesen Inhalt als /opt/eurooffice/compose.yaml. Die genannten Host-Pfade sind ein Beispiel; auf TrueNAS/VM-Hosts können andere Persistenzpfade sinnvoller sein. Prüfe die Berechtigungen für den Benutzer im Container.

cd /opt/eurooffice
sudo docker compose config --quiet
sudo docker compose up -d
sudo docker compose ps
curl --fail http://127.0.0.1:8088/healthcheck

Erfolgskontrolle: docker compose config --quiet meldet keinen YAML-Fehler, der Container läuft und curl --fail http://127.0.0.1:8088/healthcheck liefert bei erfolgreichem Start die Antwort true. Schlägt der Test fehl, prüfe zuerst docker compose logs --tail=150 eurooffice, die Speicherverfügbarkeit und die Portbelegung. Eine erfolgreiche Healthcheck-Antwort bestätigt noch nicht, dass die Verbindung in beide Richtungen zwischen Nextcloud und dem Dokumentenserver funktioniert.

Die vom Projekt dokumentierte Healthcheck-Antwort ist true. Beim allerersten Start können Initialisierung und Schrifterzeugung etwas Zeit brauchen; falls der Check fehlschlägt, kontrolliere die Logs statt den Container wiederholt zu löschen.

sudo docker compose logs --tail=150 eurooffice
sudo docker inspect euro-office --format "{{range .Mounts}}{{println .Source \"->\" .Destination}}{{end}}"

4. Test-Editor nur zeitweise freischalten

Die mitgelieferte Example-App eignet sich zur schnellen Prüfung des Editors. Sie besitzt aber keine reguläre Zugriffskontrolle und darf nicht öffentlich erreichbar bleiben. Für einen kurzen Test setzt du EXAMPLE_ENABLED auf true, erzeugst den Container neu und öffnest über einen geschützten lokalen Zugriff http://127.0.0.1:8088/example/. Danach setzt du die Variable wieder auf false und startest die Compose-Änderung erneut.

5. Eigene Domain office.example.com mit HTTPS einrichten

Erstelle beim DNS-Anbieter einen A-/AAAA-Eintrag beziehungsweise den passenden Cloudflare-Tunnel-Hostnamen für office.example.com. Die Subdomain muss zum tatsächlich zuständigen Reverse Proxy zeigen; bei Pangolin ist sie beispielsweise eine HTTP-Ressource zum Euro-Office-Zielport, bei Coolify ist sie die Domain einer entsprechend bereitgestellten Ressource.

Bei einem Reverse Proxy auf demselben Host kann das Origin-Ziel http://127.0.0.1:8088 sein. Ein Reverse Proxy in einem anderen Docker-Container darf 127.0.0.1 jedoch nicht mit dem Host verwechseln: Das bezeichnet dann seinen eigenen Container. Verwende für solche Szenarien ein gemeinsames Docker-Netz, einen geeigneten Host-Gateway oder eine private IP.

Zertifikate müssen beim zuständigen HTTPS-Endpunkt ausgestellt werden; ein Wildcard-DNS-Eintrag ersetzt kein TLS-Zertifikat. Nutze für HTTPS über Cloudflare möglichst eine gültige Origin-TLS-Verbindung. Die DNS- und Reverse-Proxy-Grundlagen erklären wir ausführlich in unserer Anleitung zu Wildcard-DNS.

6. Euro-Office in Nextcloud installieren und verbinden

  • In Nextcloud als Administrator zu Apps → Office & Text → Euro-Office integration gehen und die App installieren beziehungsweise aktivieren.
  • Unter Einstellungen → Verwaltung → Euro-Office die vollständige öffentliche Serveradresse eintragen, beispielsweise https://office.example.com.
  • Als JWT-Geheimnis den gleichen mindestens 32 Zeichen langen Wert aus der .env eintragen.
  • Speichern, eine Testdatei in Nextcloud anlegen, im Editor öffnen und Änderungen speichern.
  • Bei Fehlern aus beiden Richtungen testen, ob Nextcloud und Euro-Office einander erreichen und keine Firewall-/Hostheader-/TLS-Probleme auftreten.

Beachte: Die URL muss wirklich von der Nextcloud-Umgebung aus erreichbar sein. Eine nur auf deinem Desktop per localhost erreichbare Adresse reicht nicht.

7. Container-Updates und Backups sicher durchführen

Sichere vor dem Upgrade den vollständigen Ordner /opt/eurooffice mit den drei persistenten Verzeichnissen und der .env – möglichst bei kontrolliert gestopptem Dienst oder mit konsistentem Snapshot. Nutze für produktive Bereitstellungen nach Möglichkeit einen geprüften Versions-Tag oder Digest, damit ein Update reproduzierbar bleibt.

cd /opt/eurooffice
sudo docker compose pull
sudo docker compose up -d
sudo docker compose ps
curl --fail http://127.0.0.1:8088/healthcheck

Für das Beispiel nutzt Compose den Release-Kanal latest. Die Projekt-Dokumentation listet außerdem nightly und latest-dev für Entwicklung. Selbst wenn die Dokumentation latest nennt, solltest du auf produktiven Installationen Updates nur nach Tests übernehmen.

8. Troubleshooting: typische Probleme

Healthcheck schlägt fehl

Prüfe Docker-Logs, freien Speicher, RAM, Schreibrechte auf Daten und Logs sowie Containerstatus. Bei wiederholt sehr großen Logs zuerst Ursache ermitteln und Logrotation aktivieren, statt Datenverzeichnisse zu löschen.

Nach einem Update funktioniert JWT nicht mehr

Vergleiche den in der Compose-Umgebung gesetzten Schlüssel mit der Nextcloud-Konfiguration. Prüfe besonders, ob /var/www/euro-office/Data weiterhin dauerhaft gemountet ist. Ein zufällig neu generiertes JWT-Secret führt zu einer ungültigen Signatur.

Nextcloud kann den Dokumentenserver nicht erreichen

Teste die URL aus Sicht des Nextcloud-Containers beziehungsweise Servers, DNS, Proxy-Hostheader, TLS-Zertifikat und Firewall. Unterscheide zwischen öffentlicher HTTPS-Adresse, interner Docker-Service-Adresse und localhost.

Fehler mit privaten IP-Adressen oder Rückverbindungen

Die Option ALLOW_PRIVATE_IP_ADDRESS ist sicherheitsrelevant. Aktiviere sie nur, wenn die Architektur private Backend-Adressen erfordert, und beschränke die erreichbaren Ziele über Firewall und Netzwerksegmentierung. Eine pauschale Öffnung kann unerwünschte interne Zugriffe erleichtern.

Häufige Fragen

Speichert Euro-Office meine Nextcloud-Dateien?

Nein, die Dokumente gehören zum angeschlossenen Speicher- und Dateisystem wie Nextcloud. Euro-Office benötigt aber persistenten eigenen Zustand, Laufzeitdateien und gegebenenfalls temporäre Daten.

Kann ich Euro-Office zusammen mit Pangolin oder Coolify betreiben?

Ja. Stelle sicher, dass der richtige Reverse Proxy die Subdomain bedient und sein internes Ziel über das passende Netz erreichbar ist. Die HTTP-Ports müssen nicht alle öffentlich geöffnet werden.

Quellen und weiterführende Artikel


Schreiben Sie einen Kommentar

Ihre E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert