Skip to content

Commit 4917b8b

Browse files
committed
fix: added the paragraph above note
1 parent 02dfcf0 commit 4917b8b

File tree

1 file changed

+19
-23
lines changed

1 file changed

+19
-23
lines changed

admin_manual/configuration_files/file_versioning.rst

Lines changed: 19 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,20 @@ The Versions app never uses more than 50% of the user's currently available
2121
free space. If the stored versions exceed this limit, Nextcloud deletes the
2222
oldest 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

2640
You 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

3145
Additional 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

5569
Activate 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

Comments
 (0)