@@ -21,6 +21,20 @@ The Versions app never uses more than 50% of the user's currently available
2121free space. If the stored versions exceed this limit, Nextcloud deletes the
2222oldest file versions until it meets the disk space limit again.
2323
24+ The ``versions_retention_obligation `` setting behaves slightly differently
25+ depending on whether version expiration is triggered by an *explicit job run *
26+ (for example, via ``occ versions:expire `` or a scheduled background job) or by
27+ *automatic expiry *.
28+
29+ Explicit job-based expiration is *strict * and adheres closely to the configured
30+ ``versions_retention_obligation ``.
31+
32+ Auto-expiry follows the same retention principles but may apply them more flexibly, allowing minor deviations when
33+ necessary to maintain adequate free storage space.
34+
35+ This distinction can lead to different results depending on whether cleanup is
36+ performed automatically or manually.
37+
2438.. note :: Versions named by a user will never be deleted.
2539
2640You may alter the default pattern in ``config.php ``. The default setting is
@@ -30,12 +44,12 @@ You may alter the default pattern in ``config.php``. The default setting is
3044
3145Additional options are:
3246
33- * ``D, auto ``
34- Keep versions at least for D days, apply expiration rules to all versions
47+ * ``D, auto ``
48+ Keep versions at least for D days, apply expiration rules to all versions
3549 that are older than D days
3650
37- * ``auto, D ``
38- Delete all versions that are older than D days automatically, delete other
51+ * ``auto, D ``
52+ Delete all versions that are older than D days automatically, delete other
3953 versions according to expiration rules
4054
4155* ``D1, D2 ``
@@ -54,22 +68,4 @@ Deactivate background job: ``occ config:app:set --value=no files_versions backgr
5468
5569Activate background job: ``occ config:app:delete files_versions background_job_expire_versions ``
5670
57- Expire versions: ``occ versions:expire `` or ``occ versions:expire --quiet `` (without the progress bar)
58-
59- .. note ::
60-
61- *Deviations in behavior: “job run” vs “auto-expiry” *
62-
63- The ``versions_retention_obligation `` setting behaves slightly differently
64- depending on whether version expiration is triggered by an *explicit job run *
65- (for example, via ``occ versions:expire `` or a scheduled background job) or by
66- *automatic expiry *.
67-
68- Explicit job-based expiration is *strict * and adheres closely to the configured
69- ``versions_retention_obligation ``.
70-
71- Auto-expiry follows the same retention principles but may apply them more flexibly, allowing minor deviations when
72- necessary to maintain adequate free storage space.
73-
74- This distinction can lead to different results depending on whether cleanup is
75- performed automatically or manually.
71+ Expire versions: ``occ versions:expire `` or ``occ versions:expire --quiet `` (without the progress bar)
0 commit comments