Kurzüberblick

Getestete Basis ist die openSUSE-basierte grommunio Appliance 2026.06.1. Die Beispiele verwenden durchgehend die neutrale Appliance-Domain https://mail.example.test; Pfade wie /web/, /admin/, /auth/, /chat/, /meet/ und /files/ liegen auf derselben Appliance.Dieser Beitrag zeigt, wie du grommunio Files und Office ausgehend von der grommunio Appliance in Betrieb nimmst und mit realen Datei- und Office-Workflows prüfst.

Gezeigt werden Installation, Storage, Benutzerzugriff, Upload, Download, Freigabe, Online Office, gleichzeitige Bearbeitung, Web-Integration, Logs und Abnahme.

Getestete Umgebung

  • grommunio 2026 auf der openSUSE-basierten grommunio Appliance.

  • Alle Appliance-Befehle werden direkt auf der grommunio Appliance ausgeführt.

  • Öffentliche Beispiele verwenden durchgehend die neutrale Appliance-Domain https://mail.example.test.

1. Ausgangslage & Voraussetzungen

Ausgangspunkt ist eine grommunio-Installation mit funktionierendem DNS, TLS, Admin-Zugriff und sauberer Basisprüfung. Jeder Beitrag behandelt genau den Baustein, den du für eine vollständige Collaboration-Plattform brauchst.

2. Schritt-für-Schritt-Anleitung

Diese Anleitung zeigt dir, wie du grommunio Files und grommunio Office auf einer bestehenden grommunio-2026.06.1-Appliance installierst, konfigurierst und durchtestest. Am Ende sollen Benutzer Dateien hochladen, teilen und DOCX, XLSX sowie PPTX direkt im Browser öffnen können.

  • Du installierst grommunio Files 32.0.12 und grommunio Office 9.4.0 aus dem grommunio-Repository.

  • Du richtest Datenbanken, Storage, Redis/File-Locking, Cron und Reverse Proxy ein.

  • Du verbindest Files mit Office und prüfst den echten Editor-Workflow.

  • Du aktivierst die Files-/Office-Integration in grommunio Web.

  • Du testest Upload, Download, Teilen, zweiter Benutzer, Speichern und Wiederöffnen.

  • Du dokumentierst Betriebs-, Backup- und Troubleshooting-Punkte für eine produktive Umgebung.

Die Reihe ist chronologisch gedacht:grommunio 2026 installieren,Antispam mit Rspamd,SSO mit Keycloak,Meet,Chatund jetzt Files mit Office. Produktkontext findest du auf dergrommunio-Produktseite.

Architektur: Files, Office, Web und Auth

grommunio Files stellt Dateiablage, WebDAV, Freigaben und Benutzeroberfläche bereit. Die Paketinformationen der geprüften Appliance nennen Nextcloud als technische Basis. grommunio Office ergänzt die browserbasierte Bearbeitung und wird über die OnlyOffice-App in Files angebunden. grommunio Web kann Files als integrierten Einstiegspunkt anzeigen; die Benutzeridentität kommt in dieser Reihe aus grommunio-auth und Keycloak.

  • grommunio-auth / Keycloak
  • grommunio Web
  • Einstieg zu grommunio Files
  • WebDAV, Shares, Benutzerdateien
  • OnlyOffice-App
  • grommunio Office Document Service
  • Speichern zurück in Files

Voraussetzungen

  • Eine funktionierende grommunio-2026.06.1-Appliance mit Web, Admin, Mail und gültigem FQDN.

  • HTTPS muss über den späteren produktiven FQDN erreichbar sein. Self-Signed-Zertifikate sind nur für isolierte Labs sinnvoll.

  • Genug Speicher für Benutzerdaten, Versionen, Papierkorb, Datenbank und Backups.

  • MariaDB, nginx, PHP-FPM, Redis und Systemd müssen sauber laufen.

  • Benutzer benötigen WebDAV-/Files-Rechte. In der Lab-Prüfung waren `privWeb`, `privDav` und `privFiles` entscheidend.

  • Vor Änderungen erstellst du einen Snapshot oder ein Backup der Appliance.

Schritt 1: Baseline prüfen

Starte nicht mit der Installation, sondern mit einem kurzen Zustandsschnitt. Damit erkennst du später, ob Files/Office ein neues Problem erzeugt hat oder ob der Fehler schon vorher vorhanden war.

bash
cat /etc/os-release
hostname -f
ip addr
df -h
free -h
systemctl --failed
rpm -qa | grep -i grommunio | sort
ss -lntup

Schritt 2: Pakete und Rollen ermitteln

Auf der geprüften grommunio-2026.06.1-Appliance kamen Files und Office als native Pakete aus dem grommunio-Repository. Files brachte Nextcloud-basierte Dateiablage, Office den Document Service und RabbitMQ als Dienstabhängigkeit.

bash
zypper search -s grommunio-files grommunio-office
zypper info grommunio-files grommunio-office grommunio-office-fonts
rpm -ql grommunio-setup | grep -E 'files|office'

Geprüfte Versionen:

  • grommunio-files: 32.0.12-lp160.5.1
  • grommunio-office: 9.4.0-lp160.6.1
  • rabbitmq-server: 4.1.5
  • grommunio-web: 3.19.371.ge256c4858

Schritt 3: Files und Office installieren

Installiere Files, Office und RabbitMQ zusammen. Dadurch landen PHP-Abhängigkeiten, Office-Dienste, Fonts und die Files-Anwendung in einem konsistenten Paketstand.

bash
zypper --non-interactive install --auto-agree-with-licenses \
grommunio-files \
grommunio-office \
rabbitmq-server

Prüfe danach, ob die Pakete wirklich installiert sind. Wenn `zypper info` vorher „not installed“ gezeigt hat, muss `rpm -q` danach konkrete Versionsnummern liefern.

bash
rpm -q grommunio-files grommunio-office rabbitmq-server

Schritt 4: Datenbanken und Files-Konfiguration anlegen

Files benötigt eine eigene Datenbank und eine root-/dienstlesbare Konfiguration. Die Secrets gehören nicht in Screenshots, Tickets oder Blogartikel. Verwende Secret-Management oder mindestens root-lesbare Dateien.

bash
install -d -m 0750 /root/grommunio-secrets
openssl rand -base64 32 >/root/grommunio-secrets/files-db-password
chmod 0600 /root/grommunio-secrets/files-db-password
FILES_DB_PASSWORD="$(cat /root/grommunio-secrets/files-db-password)"
mariadb <<SQL
CREATE DATABASE IF NOT EXISTS grofiles CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
CREATE USER IF NOT EXISTS 'grofiles'@'localhost' IDENTIFIED BY '${FILES_DB_PASSWORD}';
GRANT ALL PRIVILEGES ON grofiles.* TO 'grofiles'@'localhost';
FLUSH PRIVILEGES;
SQL

Die Appliance liefert die wichtigen Pfade mit. In der geprüften Installation lagen Anwendung, Konfiguration, externe Apps, Daten und Logs an diesen Stellen.

  • /usr/share/grommunio-files
  • /usr/share/grommunio-files/config/config.php
  • /var/lib/grommunio-files/data
  • /var/lib/grommunio-files/apps-external
  • /var/log/grommunio-files/files.log

Schritt 5: Files installieren und Trusted Domains setzen

Führe die Files-Initialisierung mit dem echten FQDN aus. In einer produktiven Umgebung steht hier dein Mail-/Groupware-FQDN ohne Lab-Port. Der `overwritewebroot` bleibt `/files`, weil Files hinter nginx unter diesem Pfad veröffentlicht wird.

bash
cd /usr/share/grommunio-files
sudo -u grofiles./occ maintenance:install \
--database mysql \
--database-name grofiles \
--database-user grofiles \
--database-pass "$FILES_DB_PASSWORD" \
--admin-user grofiles-admin \
--admin-pass '<secure-admin-password>' \
--data-dir /var/lib/grommunio-files/data
MAIL_FQDN="mail.example.test"
sudo -u grofiles./occ config:system:set trusted_domains 0 --value="${MAIL_FQDN}"
sudo -u grofiles./occ config:system:set overwrite.cli.url --value="https://${MAIL_FQDN}/files"
sudo -u grofiles./occ config:system:set overwritewebroot --value="/files"
sudo -u grofiles./occ config:system:set overwriteprotocol --value="https"
sudo -u grofiles./occ config:system:set default_phone_region --value="AT"

Schritt 6: Redis, File Locking und Cron aktivieren

Dateisperren und Hintergrundjobs sind kein optionaler Schmuck. Ohne saubere Jobs bleiben Previews, Aufräumen, Versionen und manche App-Aktionen später liegen.

bash
sudo -u grofiles./occ config:system:set memcache.local --value="\\OC\\Memcache\\APCu"
sudo -u grofiles./occ config:system:set memcache.locking --value="\\OC\\Memcache\\Redis"
sudo -u grofiles./occ config:system:set redis host --value="127.0.0.1"
sudo -u grofiles./occ config:system:set redis port --value="6379" --type=integer
sudo -u grofiles./occ background:cron
systemctl enable --now grommunio-files-cron.timer

Schritt 7: Benutzerquelle anbinden

In der geprüften Appliance wurde `user_external` verwendet, damit sich grommunio-Benutzer gegen den bestehenden DAV-/Groupware-Zugang anmelden können. Dadurch entsteht kein zweiter frei erfundener Benutzerstamm in Files.

bash
cd /usr/share/grommunio-files
sudo -u grofiles./occ app:enable user_external
sudo -u grofiles./occ config:system:set user_backends 0 class --value="\\OCA\\UserExternal\\BasicAuth"
sudo -u grofiles./occ config:system:set user_backends 0 arguments 0 --value="https://${MAIL_FQDN} -f)/dav"

Prüfe danach im grommunio Admin, ob die Benutzer die passenden Rechte haben. In unserer Prüfung waren zwei normale Benutzer mit Web-, DAV- und Files-Rechten ausreichend.

bash
grommunio-admin user query username privWeb privDav privFiles --format json-flat

Schritt 8: Office-Datenbank und Dienste vorbereiten

grommunio Office benötigt eine eigene Datenbank und mehrere Dienste. RabbitMQ, `ds-docservice` und `ds-converter` müssen laufen, sonst lädt Files zwar, aber der Editor bleibt leer oder meldet Download-/Callback-Fehler.

bash
openssl rand -base64 32 >/root/grommunio-secrets/office-db-password
chmod 0600 /root/grommunio-secrets/office-db-password
OFFICE_DB_PASSWORD="$(cat /root/grommunio-secrets/office-db-password)"
mariadb <<SQL
CREATE DATABASE IF NOT EXISTS groffice CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
CREATE USER IF NOT EXISTS 'groffice'@'localhost' IDENTIFIED BY '${OFFICE_DB_PASSWORD}';
GRANT ALL PRIVILEGES ON groffice.* TO 'groffice'@'localhost';
FLUSH PRIVILEGES;
SQL
mysql groffice < /usr/libexec/grommunio-office/server/schema/mysql/createdb.sql
systemctl enable --now rabbitmq-server ds-docservice ds-converter
systemctl start ds-themegen ds-fontgen || true

Schritt 9: Files mit Office verbinden

Aktiviere die OnlyOffice-App in Files und setze die URLs passend zur nginx-Veröffentlichung. In der geprüften Umgebung war Files unter `/files/` und Office unter `/office/` erreichbar.

bash
cd /usr/share/grommunio-files
sudo -u grofiles./occ app:enable onlyoffice
sudo -u grofiles./occ config:app:set onlyoffice DocumentServerUrl --value="https://${MAIL_FQDN} -f)/office/"
sudo -u grofiles./occ config:app:set onlyoffice DocumentServerInternalUrl --value="https://${MAIL_FQDN} -f)/office/"
sudo -u grofiles./occ config:app:set onlyoffice StorageUrl --value="https://${MAIL_FQDN}/files/"
sudo -u grofiles./occ config:app:set onlyoffice customizationForcesave --value=true
sudo -u grofiles./occ config:app:set onlyoffice sameTab --value=true

Für produktive Systeme muss TLS sauber validierbar sein. In einem isolierten Self-Signed-Lab kann es nötig sein, Peer-Prüfung für den Test abzuschalten. Das ist ein Lab-Workaround, kein Produktionsstandard.

bash
# Nur für isolierte Self-Signed-Labs:
sudo -u grofiles./occ config:app:set onlyoffice verify_peer_off --value=true
# Für produktive Systeme:
sudo -u grofiles./occ config:app:delete onlyoffice verify_peer_off || true

Schritt 10: grommunio Web integrieren

Aktiviere die Files- und Office-Funktionen im grommunio-Web-Plugin. Benutzer sollen später aus Web in Files wechseln können und Office-Dateitypen direkt bearbeiten.

bash
grep -E 'PLUGIN_FILES_USER_DEFAULT_ENABLE|PLUGIN_FILES_ONLYOFFICE_ENABLE|PLUGIN_FILES_ONLYOFFICE_FILETYPES' \
/etc/grommunio-web/config-files.php
# Erwartung:
# define('PLUGIN_FILES_USER_DEFAULT_ENABLE', true);
# define('PLUGIN_FILES_ONLYOFFICE_ENABLE', true);
# define('PLUGIN_FILES_ONLYOFFICE_FILETYPES', ".doc,.docx,.docxf,.oform,.odp,.ods,.odt,.ppt,.pptx,.xls,.xlsx");

Wenn du die Werte ändern musst, passe `/etc/grommunio-web/config-files.php` an und starte die betroffenen Dienste neu. Verwende dabei den echten FQDN der Umgebung und keine frei gewählten Beispiel-URLs.

bash
systemctl restart nginx php-fpm grommunio-web || true

Von grommunio-auth über Web zu Files und Office

grommunio-auth ist der zentrale Identity-Baustein der Appliance. Für diesen Artikel zählt ausschließlich der Files-/Office-Pfad: Keycloak-Client `grommunio-files` anlegen, `user_oidc` in Files aktivieren, den grommunio-auth Files-Adapter anwenden und den Browserfluss über den echten `/files`-Pfad testen.

Geprüfter Files-Pfad:

  • Keycloak-Realm: grommunio
  • Keycloak-Client: grommunio-files
  • Files-App: user_oidc
  • Adapter-Skript: /usr/share/grommunio-auth/adaptor-config-scripts/setup-gk-app-g-files
  • Browser-Test: https://mail.example.test/files/

Für grommunio Web wurde der Einstieg über grommunio-auth und Keycloak geprüft. Die Loginseite und der MFA-Schritt sind sichtbar. In dieser Files-/Office-Prüfung war zusätzlich der DAV-basierte Files-Zugang aktiv; deshalb dokumentieren wir den getesteten DAV-Fallback und zeigen zugleich, wo die zentrale OIDC-Anbindung für Files eingehängt wird.

https://mail.example.test/web/

Screenshot: Die grommunio-auth Loginseite ist der zentrale Einstieg für grommunio Web. Prüfe hier den echten FQDN, das Zertifikat und den Realm, bevor du Files- oder Office-Probleme suchst.

https://mail.example.test/auth/

Screenshot: Die MFA-Einrichtung wird vollständig gezeigt; QR-Code und Secret sind bewusst ausgeblendet. In einer produktiven Umgebung gehören Recovery-Codes, Tokens und TOTP-Secrets nie in Screenshots oder Betriebsdokumente.

Für Files gibt es zwei saubere Betriebswege. Der schnell prüfbare Fallback nutzt `user_external` gegen den grommunio-DAV-Zugang. Der SSO-Weg nutzt die installierte `user_oidc`-App und das Adapter-Skript `setup-gk-app-g-files`. Dafür braucht Files einen eigenen vertraulichen OIDC-Client in derselben Keycloak-Realm wie grommunio Web.

Wichtig zur Plugin-Frage: Auf der geprüften 2026.06.1-Appliance waren `oauth2`, `onlyoffice`, `user_external` und `user_oidc` vorhanden. Ein `user_saml`-Plugin war dort nicht der notwendige Files-Pfad. Wenn ein Unternehmens-IdP SAML spricht, bindest du ihn sauber auf Keycloak-/grommunio-auth-Ebene ein; Files selbst bekommt in dieser Anleitung den Keycloak-Provider über OIDC.

bash
cd /usr/share/grommunio-files
sudo -u grofiles./occ app:list | grep -E 'user_oidc|user_saml|saml|oauth2|user_external|onlyoffice'

Lege den Client an, falls er fehlt: `Create client`, Client type `OpenID Connect`, Client ID `grommunio-files`. Danach bleiben `Client authentication` und `Standard flow` aktiv. `Direct access grants`, `Implicit flow` und `Service account roles` bleiben aus.

https://mail.example.test/auth/admin/

Screenshot: Der Files-Client ist ein vertraulicher OIDC-Client mit aktiviertem Standard-Flow.

Die Redirect-URIs müssen zur installierten `user_oidc`-App passen. In der geprüften Appliance waren beide Varianten sinnvoll, weil grommunio Files je nach Routing mit und ohne `index.php` zurückführen kann.

  • Valid redirect URIs:
  • https://mail.example.test/files/index.php/apps/user_oidc/code
  • https://mail.example.test/files/apps/user_oidc/code
  • Web origins:
  • https://mail.example.test
https://mail.example.test/auth/admin/

Screenshot: Die Files-Callback-URIs zeigen auf die echte `user_oidc`-Route unter `/files`.

bash
cd /usr/share/grommunio-files
sudo -u grofiles./occ app:enable user_oidc
# Der Adapter liest die von grommunio-auth erzeugte Datei:
# /var/cache/grommunio-auth/adaptor-config/keycloak-grommunio-files.json
/usr/share/grommunio-auth/adaptor-config-scripts/setup-gk-app-g-files
# Danach ohne Secret-Ausgabe prüfen:
sudo -u grofiles./occ user_oidc:providers --output=json_pretty

Wichtig für den Browserfluss: grommunio Files muss die Keycloak-Discovery serverseitig abrufen können. In Produktion verwendest du dafür ein öffentlich oder intern sauber vertrauenswürdiges TLS-Zertifikat. In einem isolierten Lab mit Self-Signed-Zertifikat reicht es nicht immer, nur den System-Truststore zu aktualisieren; grommunio Files/Nextcloud nutzt zusätzlich das eigene Bundle `/usr/share/grommunio-files/resources/config/ca-bundle.crt`. Erst wenn dieser Abruf ohne Zertifikatsfehler funktioniert, darfst du den Files-SSO-Start als technisch geprüft betrachten.

bash
curl -fsS https://mail.example.test/auth/realms/grommunio/.well-known/openid-configuration >/dev/null
# Nur im isolierten Lab mit Self-Signed-Zertifikat:
cat /etc/pki/trust/anchors/mail-example-test.pem >> /usr/share/grommunio-files/resources/config/ca-bundle.crt
systemctl restart php-fpm nginx
# Danach muss der SSO-Start zu Keycloak weiterleiten:
curl -kI https://mail.example.test/files/index.php/apps/user_oidc/login/1
https://mail.example.test/files/

Screenshot: Nach der Adapter-Konfiguration zeigt grommunio Files den Keycloak-Einstieg zusätzlich zum direkten Files-Login.

Die Redirect-URIs gehören immer zum echten FQDN und zum echten Files-Anwendungspfad. Für Files ist die OIDC-Callback-Route der installierten `user_oidc`-App maßgeblich, nicht eine frei erfundene URL.

https://mail.example.test/files/

Screenshot: Der DAV-Fallback endet auf der Files-Anmeldung. Wenn Files vollständig über Keycloak laufen soll, muss danach zusätzlich der `user_oidc`-Provider eingerichtet und als eigener Browserfluss getestet werden.

grommunio Web

Authentifizierung
grommunio-auth / Keycloak
Benutzerquelle
grommunio Benutzer
eigene Browser-Session
ja

grommunio Files

Authentifizierung
user_oidc über Keycloak oder DAV-Fallback
Benutzerquelle
Keycloak/grommunio DAV
eigene Browser-Session
konfigurationsabhängig

grommunio Office

Authentifizierung
Office-Callback über Files-App
Benutzerquelle
Files-Dokumentkontext
eigene Browser-Session
Editor-Session im Browser

Schritt 11: Healthchecks ausführen

Prüfe zuerst Dienste und HTTP-Routen. `Office /healthcheck` muss `true` liefern. Files leitet ohne Session erwartungsgemäß auf den Login weiter.

bash
systemctl --no-pager --plain is-active nginx mariadb rabbitmq-server ds-docservice ds-converter grommunio-files-cron.timer php-fpm
systemctl --failed --no-pager --plain
ss -lntup | grep -E ':(80|443|8000|3306|6379)'
curl -kIs https://${MAIL_FQDN}/files/ | head -5
curl -ks https://${MAIL_FQDN} -f)/office/healthcheck
bash
Geprüftes Ergebnis:
- Files liefert ohne Session HTTP 302 zum Login.
- Office /healthcheck liefert true.
- ds-docservice lauscht lokal auf Port 8000.
- nginx, MariaDB, RabbitMQ, ds-docservice, ds-converter, php-fpm und Files-Cron sind aktiv.
- systemctl --failed meldet 0 failed units.

Schritt 12: Login und Dateien prüfen

Öffne Files mit einem normalen grommunio-Benutzer. Wenn du direkt in Files anmelden musst, ist das im geprüften Pfad BasicAuth gegen die bestehende grommunio-Benutzerquelle. In einer vollständig durchgehenden SSO-Architektur prüfst du zusätzlich den Einstieg aus grommunio Web.

https://mail.example.test/files/

Screenshot: Login in grommunio Files mit normalem Benutzer.

Lade anschließend je eine DOCX-, XLSX- und PPTX-Datei hoch. Damit testest du nicht nur die Files-Oberfläche, sondern auch die Office-Zuordnung pro Dateityp.

bash
curl -k -u 'alice@example.test:<password>' -T ForgeOne-Files-Office-Test.docx \
https://mail.example.test/files/remote.php/dav/files/alice@example.test/ForgeOne-Files-Office-Test.docx
curl -k -u 'alice@example.test:<password>' -T ForgeOne-Files-Office-Test.xlsx \
https://mail.example.test/files/remote.php/dav/files/alice@example.test/ForgeOne-Files-Office-Test.xlsx
curl -k -u 'alice@example.test:<password>' -T ForgeOne-Files-Office-Test.pptx \
https://mail.example.test/files/remote.php/dav/files/alice@example.test/ForgeOne-Files-Office-Test.pptx
https://mail.example.test/files/

Screenshot: Files zeigt DOCX, XLSX und PPTX nach Upload und Scan.

Schritt 13: DOCX bearbeiten, speichern und wieder auslesen

Der eigentliche Abnahmetest ist nicht das Öffnen des Editors. Schreibe Text in das Dokument, speichere, schließe, lade die Datei erneut herunter und prüfe, ob die Änderung wirklich in der DOCX-Datei angekommen ist.

https://mail.example.test/files/index.php/apps/onlyoffice/29

Screenshot: DOCX im Office-Editor mit sichtbarer Teständerung.

https://mail.example.test/files/index.php/apps/onlyoffice/29

Screenshot: Der Editor meldet nach dem Speichern, dass alle Änderungen gespeichert sind.

bash
curl -k -u 'alice@example.test:<password>' \
-o /tmp/ForgeOne-Files-Office-Test.docx \
https://mail.example.test/files/remote.php/dav/files/alice@example.test/ForgeOne-Files-Office-Test.docx
unzip -p /tmp/ForgeOne-Files-Office-Test.docx word/document.xml | grep 'ForgeOne Files Office validation'

Geprüftes Ergebnis:

  • DOCX wurde im Browser geöffnet.
  • Text wurde im Editor eingefügt.
  • Speichern meldete "All changes saved".
  • WebDAV-Download lieferte eine gültige Microsoft-Word-Datei.
  • Der Marker war in word/document.xml enthalten.

Schritt 14: XLSX und PPTX prüfen

Prüfe danach mindestens eine Tabelle und eine Präsentation. In der getesteten Umgebung öffneten beide Dateitypen im passenden Office-Editor.

https://mail.example.test/files/index.php/apps/onlyoffice/30

Screenshot: XLSX öffnet im Tabelleneditor von grommunio Office.

https://mail.example.test/files/index.php/apps/onlyoffice/31

Screenshot: PPTX öffnet im Präsentationseditor von grommunio Office.

Schritt 15: Teilen mit zweitem Benutzer testen

Files ist erst dann praxisfähig, wenn Freigaben funktionieren. Teile eine Datei von Benutzer A an Benutzer B und prüfe danach den Zugriff mit einer getrennten Session.

bash
curl -k -u 'alice@example.test:<password>' \
-H 'OCS-APIRequest: true' \
--data-urlencode 'path=/ForgeOne-Files-Office-Test.docx' \
-d 'shareType=0' \
--data-urlencode 'shareWith=bob@example.test' \
-d 'permissions=15' \
'https://mail.example.test/files/ocs/v2.php/apps/files_sharing/api/v1/shares?format=json'
curl -k -u 'bob@example.test:<password>' -X PROPFIND -H 'Depth: 1' \
https://mail.example.test/files/remote.php/dav/files/bob@example.test/
https://mail.example.test/files/

Screenshot: Der zweite Benutzer sieht die geteilte DOCX-Datei in seinem Files-Konto.

Schritt 16: Webmail, Files und Office integrieren

Prüfe Files und Office zunächst eigenständig. Wenn die grommunio-Web-/Files-Integration in deiner Umgebung aktiviert ist, prüfe danach die beiden Mail-Workflows direkt im Webclient.

Workflow A: Datei aus grommunio Files als Mailanhang hinzufügen

  • ✓ Neue E-Mail in grommunio Web: Der Composer lässt sich öffnen.

  • ✓ Anhang hinzufügen: Der Anhang-Dialog ist erreichbar.

  • ✓ grommunio Files auswählen: Der Files-Einstieg ist sichtbar, wenn die Integration aktiv ist.

  • ✓ Ordner öffnen und Datei auswählen: Eine vorhandene Datei kann ausgewählt werden.

  • ✓ Mail senden: Die Datei ist als Anhang sichtbar und kommt beim Empfänger an.

Workflow B: empfangenen Mailanhang in grommunio Files speichern

  • ✓ Mail mit Anhang öffnen: Der Anhang ist in grommunio Web sichtbar.

  • ✓ Anhang-Aktionen öffnen: Die Aktion zum Speichern in Files ist sichtbar, wenn die Integration aktiv ist.

  • ✓ Zielordner auswählen: Der Zielordner in Files kann ausgewählt werden.

  • ✓ Speichern und kontrollieren: Die Datei ist danach im Zielordner in Files sichtbar.

Workflow C: Office-Dokument bearbeiten

  • ✓ Dokument in Files öffnen: Das Dokument startet im Online Office.

  • ✓ Änderung speichern: Die Änderung wird gespeichert.

  • ✓ Erneut öffnen: Die Änderung ist nach dem erneuten Öffnen vorhanden.

Ergebniskontrolle / Technische Abnahme

Installation

Prüfung
Pakete und Komponenten prüfen
Erwartetes Ergebnis
Der Baustein ist vollständig installiert
Status
PASS

Dienste

Prüfung
systemd-Services prüfen
Erwartetes Ergebnis
Die notwendigen Dienste sind aktiv
Status
PASS

Netzwerk

Prüfung
Ports und URLs prüfen
Erwartetes Ergebnis
Der Baustein ist über die vorgesehenen Pfade erreichbar
Status
PASS

Grundfunktion

Prüfung
Standalone-Test ausführen
Erwartetes Ergebnis
Die Kernfunktion funktioniert vor der tieferen Integration
Status
PASS

Authentifizierung

Prüfung
SSO/Login testen
Erwartetes Ergebnis
Der Login funktioniert über den vorgesehenen Weg oder ist bewusst nicht erforderlich
Status
PASS oder N/A

grommunio Web

Prüfung
Integration aus Web prüfen
Erwartetes Ergebnis
Der Baustein ist aus grommunio Web erreichbar oder nutzbar
Status
PASS oder N/A

End-to-End

Prüfung
Realen Benutzerworkflow testen
Erwartetes Ergebnis
Der vollständige Workflow ist nachvollziehbar erfolgreich
Status
PASS

Neustart

Prüfung
Dienste neu starten
Erwartetes Ergebnis
Die Funktion bleibt nach einem Neustart erhalten
Status
PASS

Logs

Prüfung
Relevante Logs kontrollieren
Erwartetes Ergebnis
Keine blockierenden Fehler im geprüften Ablauf
Status
PASS

4. Typische Fehler & Troubleshooting

  • Weboberfläche lädt nicht: FQDN, TLS, Reverse Proxy, Firewall und Dienststatus kontrollieren.

  • Login oder SSO schlägt fehl: Realm, Client, Redirect-URIs, Zertifikatskette, Uhrzeit und Benutzerzuordnung kontrollieren.

  • Feature bleibt leer: Paketstand, Plugins, Rechte, Logs und Hintergrunddienste kontrollieren.

5. Fazit & Ausblick

Der grommunio-Baustein ist damit nachvollziehbar eingerichtet und in die Plattform eingeordnet. Die nächsten Teile führen die Collaboration-Umgebung Schritt für Schritt weiter.