Skip to content
Merged
Changes from 2 commits
Commits
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
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.

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