diff --git a/user_manual/files/deleted_file_management.rst b/user_manual/files/deleted_file_management.rst index 13f8b3b4d..d0aa5d32c 100644 --- a/user_manual/files/deleted_file_management.rst +++ b/user_manual/files/deleted_file_management.rst @@ -1,66 +1,57 @@ -======================= -Deleted File Management -======================= +====================== +Managing Deleted Files +====================== -ownCloud maintains a copy of deleted files in case you need them again. To -ensure that individual users do not run out of storage space, the Files app manages -the amount of space allocated for deleted files for each user. When it comes to managing -quotas and calculating how much storage you need, keep the following in mind: +When you delete a file in ownCloud, it is not immediately deleted permanently. +Instead, it is moved into the trash bin. It is not permanently deleted until +you manually delete it, or when the Deleted Files app deletes it to make room +for new files. -* The total storage allocation for deleted files can never exceed more that 50% - of the currently available free space for each user. +Find your deleted files by clicking on the **Deleted files** +button on the Files page of the ownCloud Web interface. You'll have options to +either restore or permanently delete files. -* Once the 50% maximum is reached for deleted files, ownCloud begins to delete files, - starting with the oldest versions, until it reaches the storage limit again. +Quotas +------ -You can view all of the deleted files by clicking on the :guilabel:`Deleted -files` button in Files app on the web interface. +Deleted files are not counted against your storage quota. Only files that +originate with users count against their quotas, not files +shared with them that originate from other users. (See :doc:`quota` to learn +more about quotas.) -Restoring Files ---------------- +What Happens When Shared Files Are Deleted +------------------------------------------ -To restore a deleted file: +Deleting files gets a little complicated when they are shared files, as this +scenario illustrates: -1. In the Files app, click the :guilabel:`Deleted files` button. +1. User1 shares a folder "test" with User2 and User3 +2. User2 (the recipient) deletes a file/folder "sub" inside of "test" +3. The folder "sub" will be moved to the trashbin of both User1 (owner) and + User2 (recipient) +4. But User3 will not have a copy of "sub" in her trash bin - The Files app shows all deleted files. +When User1 deletes "sub" then it is moved to User1's trash bin. It is +deleted from User2 and User3, but not placed in their trash bins. - .. figure:: ../images/deleted_files.png +When you share files, other users may copy, rename, move, and share them with +other people, just as they can for any computer files; ownCloud does not have +magic powers to prevent this. - **Deleted files** +How the Deleted Files app Manages Storage Space +----------------------------------------------- -2. Hover the cursor over the file that you want to restore. +To ensure that users doesn't run over their storage quotas, the Deleted Files +app allocates a maximum of 50% of their currently available free space to +deleted files. If your deleted files exceed this limit, ownCloud deletes the +oldest files (files with the oldest timestamps from when they were deleted) +until it meets the memory usage limit again. - Task options appear for the file. - -3. Click the :guilabel:`Restore` button. - - The Files app restores the file to its original location on the server. - -Deleting Files --------------- - -To permanently delete a file: - -1. In the Files app, click the :guilabel:`Deleted files` button. - - See the **Deleted files** image above. - -2. Hover the cursor over the file that you want to delete. - - Task options appear for the file. - -3. Click the :guilabel:`Trash can` button. - - The Files app permanently removes the file from the server. - -Modifying the Deleted File Age-Out Value ----------------------------------------- - -Each time a file is added to the deleted files directory, ownCloud checks the -age of the deleted files. By default, deleted files remain in the deleted files -directory for 180 days. - -The administrator can adjust the age-out value in the ``config.php`` file by setting the -``trashbin_retention_obligation`` value. Files with ages that exceed this value -are deleted permanently. +ownCloud checks the age of deleted files every time new files are added to the +deleted files. By default, deleted files stay in the trash bin for 180 days. The +ownCloud server administrator can adjust this value in the ``config.php`` file +by setting the ``trashbin_retention_obligation`` value. Files older than the +``trashbin_retention_obligation`` value will be deleted permanently. +Additionally, ownCloud calculates the maximum available space every time a new +file is added. If the deleted files exceed the new maximum allowed space +ownCloud will expire old deleted files until the limit is met once again. \ No newline at end of file