diff --git a/admin_manual/configuration_files/file_versioning.rst b/admin_manual/configuration_files/file_versioning.rst new file mode 100644 index 000000000..18d202617 --- /dev/null +++ b/admin_manual/configuration_files/file_versioning.rst @@ -0,0 +1,51 @@ +=================================== +Controlling File Versions and Aging +=================================== + +The Versions app (files_versions) expires old file versions automatically to +ensure that users don't exceed their storage quotas. This is the default +pattern used to delete old versions: + +* For the first second we keep one version +* For the first 10 seconds ownCloud keeps one version every 2 seconds +* For the first minute ownCloud keeps one version every 10 seconds +* For the first hour ownCloud keeps one version every minute +* For the first 24 hours ownCloud keeps one version every hour +* For the first 30 days ownCloud keeps one version every day +* After the first 30 days ownCloud keeps one version every week + +The versions are adjusted along this pattern every time a new version is +created. + +The Versions app never uses more that 50% of the user's currently available +free space. If the stored versions exceed this limit, ownCloud deletes the +oldest file versions until it meets the disk space limit again. + +You may alter the default pattern in ``config.php``. The default setting is +``auto``, which sets the default pattern:: + + 'versions_retention_obligation' => 'auto', + +Additional options are: + +* ``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 + versions according to expiration rules + +* ``D1, D2`` + Keep versions for at least D1 days and delete when they exceed D2 days. + +* ``disabled`` + Disable Versions; no files will be deleted. + +Enterprise File Retention +------------------------- + +Enterprise customers have additional tools for managing file retention +policies; see :doc:`../enterprise_file_management/files_tagging`. + + \ No newline at end of file diff --git a/admin_manual/configuration_files/index.rst b/admin_manual/configuration_files/index.rst index 680db3b8a..ced39e985 100644 --- a/admin_manual/configuration_files/index.rst +++ b/admin_manual/configuration_files/index.rst @@ -17,3 +17,4 @@ File Sharing and Management encryption_configuration files_locking_transactional previews_configuration + file_versioning