Skip to content

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.

Sign up for GitHub

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

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
+18 −4
Open

fix: add note about change in behaviour of the job #13795

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
02dfcf0
fix: add note about change in behaviour of the job
yemkareems Oct 13, 2025
4917b8b
fix: added the paragraph above note
yemkareems Oct 23, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 18 additions & 4 deletions admin_manual/configuration_files/file_versioning.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Copy link
Contributor

Choose a reason for hiding this comment

The 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.

Copy link
Contributor Author

Choose a reason for hiding this comment

The 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
Expand All @@ -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``
Expand Down
Loading