From 2faa5e894b95880d80f9f751c6eff76d1cb649ac Mon Sep 17 00:00:00 2001 From: Josh Date: Wed, 4 Mar 2026 10:22:11 -0500 Subject: [PATCH 1/2] docs(config): improve `filesystem_cache_readonly` docs - Add more extensive explanation - Explain interaction/relation to more commonly used option: `filesystem_check_changes` - Add warning Signed-off-by: Josh --- config/config.sample.php | 27 ++++++++++++++++++++++++--- 1 file changed, 24 insertions(+), 3 deletions(-) diff --git a/config/config.sample.php b/config/config.sample.php index f85a1da6a5be5..4748b15879d3c 100644 --- a/config/config.sample.php +++ b/config/config.sample.php @@ -2490,10 +2490,31 @@ 'mount_file' => '/var/www/nextcloud/data/mount.json', /** - * Prevent Nextcloud from updating the cache due to filesystem changes for all - * storage. + * Read-only mode for scan/detection reconciliation writes to filecache. * - * Defaults to ``false`` + * When true, Nextcloud does not store filecache metadata changes that are + * identified through scanner/change-detection reconciliation paths (global: + * all storages). + * + * Scope note: + * + * - Nextcloud-originated operations (UI/WebDAV/clients) are generally + * handled through normal application write paths and thus will still + * update filecache even when this is set to true. + * - Reconciliation/refresh paths are prevented from writing back discovered + * metadata deltas while this is enabled. + * + * Practical effect: + * + * - Changes made directly on storage outside Nextcloud are generally not + * reflected while enabled. + * - Some metadata-dependent behavior can appear stale until this parameter + * is disabled (permitting reconciliation writes again). + * + * Warning: This is an expert/global setting for specialized environments and + * is intentionally not default-safe for general deployments. + * + * Defaults to ``false``. */ 'filesystem_cache_readonly' => false, From 052d62b83cf8e3cee61095ef151890f144ec9e16 Mon Sep 17 00:00:00 2001 From: Josh Date: Wed, 4 Mar 2026 11:41:36 -0500 Subject: [PATCH 2/2] docs(config): make cs happy fixup Signed-off-by: Josh --- config/config.sample.php | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/config/config.sample.php b/config/config.sample.php index 4748b15879d3c..c7050e7fc049d 100644 --- a/config/config.sample.php +++ b/config/config.sample.php @@ -2493,7 +2493,7 @@ * Read-only mode for scan/detection reconciliation writes to filecache. * * When true, Nextcloud does not store filecache metadata changes that are - * identified through scanner/change-detection reconciliation paths (global: + * identified through scanner/change-detection reconciliation paths (global: * all storages). * * Scope note: