Add a note to the config documentation that the 'delete_stale_devices_after' job always runs on the main process (#15452)

2 files changed, 5 insertions, 0 deletions

diff --git a/changelog.d/15452.doc b/changelog.d/15452.doc
new file mode 100644

index 0000000000..330c90b3d6
--- /dev/null
+++ b/changelog.d/15452.doc
@@ -0,0 +1 @@
+Note that the `delete_stale_devices_after` background job always runs on the main process.
\ No newline at end of file
diff --git a/docs/usage/configuration/config_documentation.md b/docs/usage/configuration/config_documentation.md

index c5c2c2b615..1b6f256949 100644
--- a/docs/usage/configuration/config_documentation.md
+++ b/docs/usage/configuration/config_documentation.md
@@ -577,6 +577,10 @@ delete any device that hasn't been accessed for more than the specified amount o
 
 Defaults to no duration, which means devices are never pruned.
 
+**Note:** This task will always run on the main process, regardless of the value of
+`run_background_tasks_on`. This is due to workers currently not having the ability to
+delete devices.
+
 Example configuration:
 ```yaml
 delete_stale_devices_after: 1y