Skip to content

Commit a8b4526

Browse files
committed
docs(activity): clarify enable_email toggle scope and queue drain behaviour
Signed-off-by: Anna Larch <anna@nextcloud.com>
1 parent 8b051c6 commit a8b4526

1 file changed

Lines changed: 25 additions & 0 deletions

File tree

admin_manual/configuration_server/activity_configuration.rst

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -47,6 +47,15 @@ As an administrator, you can:
4747
Existing users keep their personal settings. The defaults apply
4848
to accounts created after the change.
4949

50+
.. note::
51+
52+
The **Enable notification emails** toggle prevents **new** emails from
53+
being queued. It does not retroactively remove emails that are already
54+
waiting in the queue. Emails queued before the toggle was disabled will
55+
still be sent by the background job on its next run. To stop those
56+
emails immediately, truncate or clear the ``oc_activity_mq`` database
57+
table.
58+
5059

5160
Configuration reference
5261
-----------------------
@@ -193,3 +202,19 @@ database growth. To manage this:
193202
expiration job executes.
194203
* To assess current database usage, check the size of the
195204
``oc_activity`` and ``oc_activity_mq`` tables directly.
205+
206+
Emails are still being sent after disabling notification emails
207+
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
208+
209+
The **Enable notification emails** toggle is checked when *queuing* new
210+
emails. The background job that actually delivers emails
211+
(``MailQueueHandler``) does not re-read the toggle before sending, so
212+
emails that were already in the queue when the toggle was turned off will
213+
still be delivered.
214+
215+
To stop those emails immediately, clear the ``oc_activity_mq`` table::
216+
217+
DELETE FROM oc_activity_mq;
218+
219+
After clearing the table, no further queued activity emails will be sent
220+
until new ones are queued (which requires the toggle to be re-enabled).

0 commit comments

Comments
 (0)