From 5b3e5e0348812cb3374e9f046d15d200710128b3 Mon Sep 17 00:00:00 2001 From: Wolfgang Lubowski Date: Wed, 13 May 2026 13:47:16 +0200 Subject: [PATCH] docs(admin): document mail preview_enhancement_interval Add a section to the Mail admin manual documenting the new preview_enhancement_interval app config introduced in nextcloud/mail#12791. Mirrors the placement and wording of the existing Background sync interval section, but uses the IAppConfig / occ config:app:set syntax matching the new key. AI-assisted: Claude Code (Claude Opus 4.7) Signed-off-by: Wolfgang Lubowski --- admin_manual/groupware/mail.rst | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/admin_manual/groupware/mail.rst b/admin_manual/groupware/mail.rst index 73cbbaf8868..85ed5e8b431 100644 --- a/admin_manual/groupware/mail.rst +++ b/admin_manual/groupware/mail.rst @@ -50,6 +50,23 @@ Configure how often Mail keeps users' mailboxes updated in the background in sec 'app.mail.background-sync-interval' => 7200, +Preview enhancement interval +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Configure how often the preview-enhancement background job runs in seconds. Defaults to 3600, minimum 60. + +This job populates the ``imip_message`` flag on incoming messages. The iMIP background job, which turns calendar +invitations into actual events, only picks up messages once that flag is set, so this interval is the upper bound +on how long an inbound invitation can take to appear in the user's calendar. Smaller setups that want invitations +to feel live can lower this to the 60–300 second range; larger installations should keep the default to avoid +extra database load. + +:: + + occ config:app:set mail preview_enhancement_interval --value=300 --type=integer + +The new value takes effect on the next scheduler tick — no service restart required. + Disable TLS verification for IMAP/SMTP ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^