So löschen Sie den ownCloud-Dateiversionsverlauf über die Befehlszeile

Mit der ownCloud-Befehlszeile lässt sich Speicherplatz freigeben, indem Dateiversionen entfernt werden. Der richtige Befehl hängt jedoch davon ab, was Sie unter „Löschen“ verstehen. Sie können ownCloud nur Versionen löschen lassen, die gegen die konfigurierte Aufbewahrungsrichtlinie verstoßen, alle gespeicherten Versionen für ein oder mehrere Konten entfernen oder alle Versionen systemweit löschen. Diese Optionen unterscheiden sich deutlich hinsichtlich ihrer Reversibilität und ihres Umfangs. Prüfen Sie zunächst, ob Sie einen ownCloud Server oder ownCloud Infinite Scale verwenden ; diese verwenden unterschiedliche Befehlszeilentools.

Die folgenden Befehle basieren auf der aktuellen Administrationsdokumentation von ownCloud Server 10.16 und 11.0 sowie dem Infinite Scale 8.2-Leitfaden (Stand: 6. Oktober 2026). Pfade, Dienstnamen und Konto-IDs variieren je nach Installation. Passen Sie die Beispiele daher an, bevor Sie sie auf einem Produktionsserver ausführen.

Wählen Sie die Reinigungsmethode, die Ihrem Ziel entspricht.

Für die Verwaltung wiederkehrender Speichervorgänge beginnen Sie mit der Aufbewahrungsrichtlinie versions:expire. Verwenden Sie diese Option versions:cleanupnur, wenn Sie den ausgewählten Verlauf bewusst und sofort löschen möchten.

1. Bestätigen Sie Ihr ownCloud-Produkt und den Befehlsstandort.

Für ownCloud Server verbinden Sie sich mit dem Host oder Container, auf dem die PHP-Anwendung ausgeführt wird, und wechseln Sie in das ownCloud-Installationsverzeichnis, in dem sich das occSkript befindet. Unter Linux ist es üblich, Befehle als Webserver-Konto auszuführen, oft mit dem Benutzerkonto `/webserver` www-dataoder `/webserver wwwrun/localhost`.

cd /var/www/owncloud
sudo -u www-data php occ status

Verwenden Sie den tatsächlichen Installationspfad und das Webserver-Konto Ihres Systems. Die Ausführung occals Root kann dazu führen, dass Dateien dem falschen Konto zugeordnet werden. Verwenden Sie daher das dokumentierte Dienstkonto. Stellen Sie sicher, dass die Versionsverwaltung files_versionsaktiviert ist. Die Versionsbefehle sind nicht verfügbar, wenn diese App deaktiviert ist, und stehen im Einzelbenutzer-Wartungsmodus nicht zur Verfügung.

Wenn ownCloud Server in Docker ausgeführt wird, führen Sie den Befehl innerhalb des Anwendungscontainers aus. Beispielsweise kann eine Bereitstellung im Verzeichnis Ihrer Compose-Konfiguration den Befehl verwenden docker compose exec owncloud occ status; ersetzen Sie owncloud`<service>` durch den tatsächlichen Dienstnamen in Ihrer Compose-Datei. Verwenden Sie nicht die occBeispiele für Infinite Scale.

2. Entscheiden Sie, ob die Aufbewahrung erzwungen oder der Verlauf gelöscht werden soll.

Verwenden Sie das Ablaufdatum, wenn Sie eine richtlinienbasierte Bereinigung wünschen.

versions:expireBewertet Versionen anhand der versions_retention_obligationEinstellung in config.php. Ohne Benutzer-ID gilt dies für alle Benutzer; Sie können auch eine oder mehrere Benutzer-IDs angeben. Für ein einzelnes Konto lautet der Befehl:

sudo -u www-data php occ versions:expire alice

Verwenden Sie die tatsächliche Konto-ID und nicht den Anzeigenamen oder die E-Mail-Adresse des Nutzers, es sei denn, das Konto wird in Ihrer Installation so identifiziert. Um den Ablaufvorgang für alle Konten durchzuführen, lassen Sie den Parameter weg alice. Diese Option berücksichtigt die konfigurierte Aufbewahrungsregel: Aktuelle oder anderweitig aufbewahrte Versionen werden nicht zwangsläufig gelöscht.

Die ownCloud Server-Dokumentation beschreibt autodas Standard-Aufbewahrungsmuster und dokumentiert auch zeitbasierte Alternativen. Überprüfen Sie Ihre Richtlinien, bevor Sie die Ablaufzeit festlegen, insbesondere wenn Ihr Unternehmen rechtliche oder betriebliche Aufbewahrungspflichten hat. Bei normaler, wiederkehrender Ablaufzeit führt ownCloud dies als Hintergrundprozess aus. Das Administrationshandbuch empfiehlt die Verwendung von System-Cron für Hintergrundprozesse. Die manuelle Ausführung der Ablaufzeit ist zwar für geplante Wartungsarbeiten nützlich, sollte aber kein Ersatz für einen korrekt konfigurierten Scheduler sein.

Verwenden Sie die Bereinigungsfunktion, wenn Sie beabsichtigen, jede Version im Gültigkeitsbereich zu löschen.

Für ein Konto führen Sie Folgendes aus:

sudo -u www-data php occ versions:cleanup alice

Geben Sie für mehrere Konten deren IDs durch Leerzeichen getrennt an:

sudo -u www-data php occ versions:cleanup alice bob

Ohne IDs entfernt der Befehl alle versionierten Dateien für alle Benutzer:

sudo -u www-data php occ versions:cleanup

Erstellen Sie zunächst ein Backup, falls die Versionen für die Wiederherstellung benötigt werden könnten, und überprüfen Sie die Konto-IDs vor der Ausführung. Der dokumentierte Befehl löscht die Versionsdaten und den zugehörigen files_versionsOrdner. Außerdem werden veröffentlichte Versionen entfernt, die andernfalls über die normale Aufbewahrungsfrist hinaus bestehen bleiben würden. Für ownCloud Server gibt es keine dokumentierte Option für die reine Vorschau versions:cleanup, daher kann ein Tippfehler oder eine fehlende ID größere Auswirkungen haben als beabsichtigt.

3. Den Unterschied zwischen ownCloud Server und Infinite Scale verstehen.

ownCloud Infinite Scale (oCIS) verwendet den PHP- occ versions:cleanupBefehl nicht. Die Administrationsdokumentation beschreibt die Revisionsbereinigung mit dem ocis revisions purgeBefehl `revision clean`. Standardmäßig wird ein Testlauf durchgeführt, der anzeigt, was entfernt würde, ohne Revisionen zu löschen. Der konfigurierte Speicherpfad des Benutzers ist erforderlich; in diesem Beispiel wird ein Platzhalterpfad verwendet.

ocis revisions purge -p /base/path/storage/users

Überprüfen Sie die Ergebnisse des Testlaufs und stellen Sie sicher, dass der Speicherpfad korrekt ist. Um die in diesem Testlauf aufgeführten Änderungen tatsächlich zu entfernen, deaktivieren Sie den Testlauf explizit.

ocis revisions purge --dry-run=false -p /base/path/storage/users

Standardmäßig werden mit dem Befehl „Unendliche Skalierung“ Revisionen in allen Bereichen berücksichtigt. Mit einer --resource-idOption lässt sich der Vorgang auf einen Bereich oder eine einzelne Datei beschränken, sofern die korrekte ID vorliegt. Bei Unklarheiten bezüglich Pfad oder Bereich empfiehlt es sich, einen Testlauf durchzuführen und beides anhand Ihrer Bereitstellungskonfiguration zu überprüfen. Die Dokumentation weist darauf hin, dass alternative Globbing-Modi die CPU- und Speicherauslastung in großen Bereichen erhöhen können. Verwenden Sie daher die Standardeinstellung, sofern keine Notwendigkeit für eine Änderung besteht.

4. Überprüfen Sie das Ergebnis, ohne weitere Daten zu löschen.

Überprüfen Sie nach der Serverbereinigung einige repräsentative Konten in der Weboberfläche und vergewissern Sie sich, dass keine alten Einträge mehr im Versionsverlauf der einzelnen Dateien angezeigt werden. Prüfen Sie die Befehlsausgabe für die verarbeiteten Benutzer. Vergleichen Sie bei Infinite Scale die Ergebnisse der Bereinigung mit der Ausgabe des Testlaufs und überprüfen Sie den Abschlussstatus des Befehls. Prüfen Sie anschließend die Speichernutzung auf der für Ihre Bereitstellung relevanten Ebene: ownCloud-Kontingentberichte, das lokale Dateisystem oder den konfigurierten Objektspeicher.

Entfernen Sie keine Dateien manuell, um files_versionseine Bereinigung abzuschließen. Die von ownCloud unterstützten Befehle koordinieren die Versionsbereinigung mit den Anwendungsmetadaten. Das Löschen von Speicherobjekten hinter der Anwendung kann zu inkonsistenten Datensätzen führen. Außerdem kann die freigegebene Serverfestplatte von der Anzahl der entfernten Versionen abweichen, wenn Ihr Speichersystem Snapshots, Replikation oder ein eigenes verzögertes Löschverhalten verwendet. Dies hängt vom jeweiligen Speichersystem ab und muss mit dessen Administrator oder Anbieter geklärt werden.

Welche Option sollten Sie wählen?

• Wählen Sie diese Optionversions:expire , wenn Ihr Ziel die fortlaufende Quotenverwaltung unter Einhaltung bestehender Aufbewahrungsregeln ist.
• Wählen Sie die Option „Bereichsbeschränkt“versions:cleanup USER_ID , wenn Sie den gesamten Verlauf bekannter Konten löschen müssen und den Verlust von Wiederherstellungspunkten in Kauf genommen haben.
• Wählen Sie „Nur global“versions:cleanup für einen gezielten systemweiten Reset nach der Datensicherung und Überprüfung des Geltungsbereichs.
• Wählen Sie den Infinite Scale-Bereinigungsworkflow nur auf oCIS aus und überprüfen Sie dessen standardmäßigen Testlauf, bevor Sie die Einstellungen vornehmen --dry-run=false.

Offizielle Referenzen: ownCloud Server OCC-Befehlsreferenz , ownCloud Server Dateiversionierung und -aufbewahrung , ownCloud Server Hintergrundjobs und Infinite Scale Revisionsbereinigung .

Versionshinweis: Das Befehlsverhalten und die Beispiele wurden am 6. Oktober 2026 anhand der Dokumentation zu ownCloud Server 10.16/11.0 und Infinite Scale 8.2 überprüft. Prüfen Sie vor der Durchführung eines destruktiven Vorgangs das entsprechende Handbuch für Ihre installierte Version.