upstream/nextcloud
1
0
Fork 0
mirror of https://github.com/nextcloud/server.git synced 2026-05-28 04:32:30 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions 25

Merge pull request #58723 from nextcloud/jtr/docs-config-fs-cache-RO

Browse source 
docs(config): improve `filesystem_cache_readonly` docs
This commit is contained in:
Robin Appelman 2026-03-05 14:29:08 +01:00 committed by GitHub
commit b40d230218
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 24 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

27
config/config.sample.php
View file

@ -2490,10 +2490,31 @@ $CONFIG = [
'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,