{"record":{"id":"f58d29d6e179ba20","repo":"RocketChat/Rocket.Chat","slug":"the-value-of-the-setting-crowd-background-synchro","errorCode":null,"errorMessage":"The value of the setting 'CROWD background synchronization interval' has changed from \"${crowdSyncInterval.value}\" to \"${newCrowdDefault}\". Please review your settings.","messagePattern":"The value of the setting 'CROWD background synchronization interval' has changed from \"(.+?)\" to \"(.+?)\"\\. Please review your settings\\.","errorType":"console","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"apps/meteor/server/startup/migrations/v295.ts","lineNumber":40,"sourceCode":"\n\t\t// update setting values\n\t\tawait updateAuditedBySystem({\n\t\t\treason: 'Migration 295',\n\t\t})(Settings.updateValueById, 'LDAP_Background_Sync_Interval', newLdapDefault);\n\t\tawait updateAuditedBySystem({\n\t\t\treason: 'Migration 295',\n\t\t})(Settings.updateValueById, 'CROWD_Sync_Interval', newCrowdDefault);\n\n\t\t// notify user about the changes if the value was different from the default\n\n\t\tif (ldapSyncInterval && ldapSyncInterval.value !== oldLdapDefault) {\n\t\t\tSystemLogger.warn(\n\t\t\t\t`The value of the setting 'LDAP background synchronization interval' has changed from \"${ldapSyncInterval.value}\" to \"${newLdapDefault}\". Please review your settings.`,\n\t\t\t);\n\t\t}\n\n\t\tif (crowdSyncInterval && crowdSyncInterval.value !== oldCrowdDefault) {\n\t\t\tSystemLogger.warn(\n\t\t\t\t`The value of the setting 'CROWD background synchronization interval' has changed from \"${crowdSyncInterval.value}\" to \"${newCrowdDefault}\". Please review your settings.`,\n\t\t\t);\n\t\t}\n\t},\n});\n","sourceCodeStart":22,"sourceCodeEnd":46,"githubUrl":"https://github.com/RocketChat/Rocket.Chat/blob/b2c16d5842cbe6b69b59bdf6fc5e5f1afcd1f0b0/apps/meteor/server/startup/migrations/v295.ts#L22-L46","documentation":"Companion of the LDAP warning in the same migration 295, this one covers CROWD_Sync_Interval. The old default was the free-text 'Every 60 mins'; the migration unconditionally rewrites the value to the new predefined 'every_1_hours' via updateAuditedBySystem({reason: 'Migration 295'}). The SystemLogger.warn fires only when the workspace had a non-default pre-upgrade value (crowdSyncInterval.value !== 'Every 60 mins'), i.e. a customized CROWD sync cadence is being replaced.","triggerScenarios":"Migration 295 executes during post-upgrade startup and the stored CROWD_Sync_Interval value is anything other than 'Every 60 mins' — for example 'Every 24 hours' or another custom string entered in the old field. The value is forced to 'every_1_hours' and the warning (old value -> new value) is logged once.","commonSituations":"Atlassian CROWD customers upgrading old Rocket.Chat installations where the sync interval had been tuned (typically slowed down to reduce load on the CROWD server). The migration normalizes cadence to hourly regardless of the previous setting, which can increase load on the CROWD server after upgrade.","solutions":["After upgrade, review Admin -> CROWD and set 'CROWD background synchronization interval' to the cadence you want from the now-predefined options.","Pre-upgrade, record the current CROWD_Sync_Interval value (the warning also prints it) so you can restore intent.","Watch CROWD server load after upgrade — defaulting to hourly can hammer a previously 24h-synced directory.","Confirm via the audit log that the change was made by 'Migration 295', not by a user."],"exampleFix":"// restore a slower cadence after migration 295\nawait Settings.updateValueById('CROWD_Sync_Interval', 'every_24_hours'); // pick a supported option","handlingStrategy":"validation","validationCode":"// Pre-upgrade check for the CROWD companion setting\nconst crowd = await Settings.getValueById('CROWD_Sync_Interval');\nif (crowd && crowd !== 'Every 60 mins') {\n  console.log(`Custom CROWD interval \"${crowd}\" will be reset to every_1_hours by migration 295 — review after upgrade`);\n}","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Record CROWD_Sync_Interval before upgrading; the migration forces hourly sync for everyone.","Check CROWD server load after upgrade since the default cadence is now hourly.","Restore the intended cadence from the predefined options immediately after the first post-upgrade startup."],"tags":["migration","crowd","ldap","settings","upgrade","breaking-change"],"backgroundTag":"migration-overwrote-setting","analyzedSha":"b2c16d5842cbe6b69b59bdf6fc5e5f1afcd1f0b0","analyzedAt":"2026-08-18T15:26:39.429Z","contentChangedAt":"2026-08-18T15:26:39.429Z","schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}