| 1 |
.. _imap-features-delayed-delete: |
| 2 |
|
| 3 |
============== |
| 4 |
Delayed Delete |
| 5 |
============== |
| 6 |
|
| 7 |
It is not uncommon for a folder or hierarchy of folders in IMAP to |
| 8 |
contain large amounts of information -- after all, IMAP preserves a copy |
| 9 |
of the messages on the server unless it is specifically deleted. |
| 10 |
|
| 11 |
Three challenges arise when users delete folders especially if an |
| 12 |
organization is required to comply with archiving regulations; |
| 13 |
|
| 14 |
#. How to restore the folder if the deletion was accidental? |
| 15 |
|
| 16 |
#. How to ensure the folder being deleted remains available for |
| 17 |
inclusion in the next backup cycle? |
| 18 |
|
| 19 |
#. The deletion of a hierarchy with a lot of messages can create an I/O |
| 20 |
storm unlinking many individual files and some directories. |
| 21 |
|
| 22 |
Cyrus IMAP introduces *delayed deletion* of folders, which leaves the |
| 23 |
deleted folder (or hierarchy thereof) on the filesystem, such that |
| 24 |
purging the folder hierarchy from the filesystem; |
| 25 |
|
| 26 |
* becomes a separate event (perhaps triggered during the weekend), |
| 27 |
|
| 28 |
* can be delayed such that users have a chance to report accidental |
| 29 |
deletion and administrators can recover without requiring a restore |
| 30 |
from backup, |
| 31 |
|
| 32 |
* can be delayed as to ensure that the next backup cycle includes the |
| 33 |
deleted folder hierarchy. |
| 34 |
|
| 35 |
----------------------------------------- |
| 36 |
Configuring Cyrus IMAP for Delayed Delete |
| 37 |
----------------------------------------- |
| 38 |
|
| 39 |
To enable or disable Delayed Delete, please check the following settings |
| 40 |
in :cyrusman:`imapd.conf(5)`. |
| 41 |
|
| 42 |
.. include:: /imap/reference/manpages/configs/imapd.conf.rst |
| 43 |
:start-after: startblob delete_mode |
| 44 |
:end-before: endblob delete_mode |
| 45 |
|
| 46 |
.. include:: /imap/reference/manpages/configs/imapd.conf.rst |
| 47 |
:start-after: startblob deletedprefix |
| 48 |
:end-before: endblob deletedprefix |
| 49 |
|
| 50 |
.. seealso:: |
| 51 |
|
| 52 |
* :ref:`imap-features-delayed-expunge` |
| 53 |
* :ref:`imap-admin-deleted-expired-expunged-purged` |
| 54 |
|
| 55 |
Back to :ref:`imap-features` |