-
Notifications
You must be signed in to change notification settings - Fork 2.2k
fix: add note about change in behaviour of the job #13795
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -21,6 +21,20 @@ The Versions app never uses more than 50% of the user's currently available | |
| free space. If the stored versions exceed this limit, Nextcloud deletes the | ||
| oldest file versions until it meets the disk space limit again. | ||
|
|
||
| The ``versions_retention_obligation`` setting behaves slightly differently | ||
| depending on whether version expiration is triggered by an *explicit job run* | ||
| (for example, via ``occ versions:expire`` or a scheduled background job) or by | ||
| *automatic expiry*. | ||
|
|
||
| Explicit job-based expiration is *strict* and adheres closely to the configured | ||
| ``versions_retention_obligation``. | ||
|
|
||
| Auto-expiry follows the same retention principles but may apply them more flexibly, allowing minor deviations when | ||
| necessary to maintain adequate free storage space. | ||
|
Comment on lines
+32
to
+33
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. I don't think that is true, or if it is, then we need to be explicit on what are the deviations. Admins need to know what's happening with the files. There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Is it fine to change it to "Auto-expiry follows the same retention principles as standard version retention. However, when the available storage space becomes critically low, Nextcloud may delete older versions earlier than their configured retention period to free up space." |
||
|
|
||
| This distinction can lead to different results depending on whether cleanup is | ||
| performed automatically or manually. | ||
|
|
||
| .. note:: Versions named by a user will never be deleted. | ||
|
|
||
| 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 | |
|
|
||
| Additional options are: | ||
|
|
||
| * ``D, auto`` | ||
| Keep versions at least for D days, apply expiration rules to all versions | ||
| * ``D, auto`` | ||
| Keep versions at least for D days, apply expiration rules to all versions | ||
| that are older than D days | ||
|
|
||
| * ``auto, D`` | ||
| Delete all versions that are older than D days automatically, delete other | ||
| * ``auto, D`` | ||
| Delete all versions that are older than D days automatically, delete other | ||
| versions according to expiration rules | ||
|
|
||
| * ``D1, D2`` | ||
|
|
||