Skip to content

Commit 0d7dea1

Browse files
committed
chore(administration): Generate system config documentation from config.sample.php
1 parent 674d7f7 commit 0d7dea1

1 file changed

Lines changed: 56 additions & 8 deletions

File tree

admin_manual/configuration_server/config_sample_php_parameters.rst

Lines changed: 56 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -2748,6 +2748,21 @@ Memory caching backend for distributed data
27482748

27492749
Defaults to ``none``
27502750

2751+
memcache_customprefix
2752+
^^^^^^^^^^^^^^^^^^^^^
2753+
2754+
2755+
::
2756+
2757+
'memcache_customprefix' => 'mycustomprefix',
2758+
2759+
Cache Key Prefix for Redis or Memcached
2760+
2761+
* Used for avoiding collisions in the cache system
2762+
* May be used for ACL restrictions in Redis
2763+
2764+
Defaults to ``''`` (empty string)
2765+
27512766
redis
27522767
^^^^^
27532768

@@ -3777,12 +3792,24 @@ part_file_in_storage
37773792

37783793
'part_file_in_storage' => true,
37793794

3780-
Store part files created during upload in the same storage as the upload
3781-
target. Setting this to false stores part files in the root of the user's
3782-
folder, which may be necessary for external storage with limited rename
3783-
capabilities.
3795+
Control where temporary ".part" files are written during direct (non-chunked)
3796+
uploads.
37843797

3785-
Defaults to ``true``
3798+
While an upload is in progress, Nextcloud writes data to a temporary ".part"
3799+
file and renames it to the final filename when the upload completes.
3800+
3801+
- true: create the temporary ".part" file in the destination storage/path.
3802+
This typically avoids cross-storage moves and can improve reliability and
3803+
performance on backends where rename within the same storage is cheap/atomic.
3804+
- false: create the temporary ".part" file in the user's root folder first.
3805+
This may help with some external storages that have limited rename/move
3806+
behavior, but can add extra copy/move overhead.
3807+
3808+
Note: This setting applies to direct (non-chunked) uploads only. Chunked/
3809+
resumable uploads use a separate uploads staging mechanism and are not
3810+
controlled by this option.
3811+
3812+
Defaults to ``true``.
37863813

37873814
mount_file
37883815
^^^^^^^^^^
@@ -3804,10 +3831,31 @@ filesystem_cache_readonly
38043831

38053832
'filesystem_cache_readonly' => false,
38063833

3807-
Prevent Nextcloud from updating the cache due to filesystem changes for all
3808-
storage.
3834+
Read-only mode for scan/detection reconciliation writes to filecache.
38093835

3810-
Defaults to ``false``
3836+
When true, Nextcloud does not store filecache metadata changes that are
3837+
identified through scanner/change-detection reconciliation paths (global:
3838+
all storages).
3839+
3840+
Scope note:
3841+
3842+
- Nextcloud-originated operations (UI/WebDAV/clients) are generally
3843+
handled through normal application write paths and thus will still
3844+
update filecache even when this is set to true.
3845+
- Reconciliation/refresh paths are prevented from writing back discovered
3846+
metadata deltas while this is enabled.
3847+
3848+
Practical effect:
3849+
3850+
- Changes made directly on storage outside Nextcloud are generally not
3851+
reflected while enabled.
3852+
- Some metadata-dependent behavior can appear stale until this parameter
3853+
is disabled (permitting reconciliation writes again).
3854+
3855+
Warning: This is an expert/global setting for specialized environments and
3856+
is intentionally not default-safe for general deployments.
3857+
3858+
Defaults to ``false``.
38113859

38123860
trusted_proxies
38133861
^^^^^^^^^^^^^^^

0 commit comments

Comments
 (0)