Skip to content

Commit f33ca84

Browse files
committed
docs(admin): address remaining review feedback
- Drop "first...per PHP request" phrasing β€” only one PROPFIND per PHP request, so the qualifier was false; simplify to "on each PROPFIND request" - Fix renames-section reference: "option A" is SMB notify, not "Once per direct access"; use the mount option name directly instead - Restore AIO note for files_external:scan (removed in previous commit but reviewer wants it kept, using updated command) Signed-off-by: skjnldsv <skjnldsv@protonmail.com>
1 parent d400487 commit f33ca84

1 file changed

Lines changed: 9 additions & 2 deletions

File tree

β€Žadmin_manual/configuration_files/external_storage_configuration_gui.rstβ€Ž

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -105,7 +105,7 @@ individually with the following options:
105105
* Enable Sharing
106106
* **Filesystem check frequency** β€” controls how the server rescans an external
107107
storage path when a WebDAV ``PROPFIND`` request arrives for it.
108-
**Once per direct access** rescans on the first ``PROPFIND`` per PHP request;
108+
**Once per direct access** rescans on each ``PROPFIND`` request;
109109
**Never** skips the rescan entirely. This setting does *not* cause Nextcloud
110110
or desktop clients to poll automatically. See
111111
:ref:`external_storage_change_detection_label` for details.
@@ -238,11 +238,18 @@ rescans the external storage periodically using its mount ID:
238238
See :doc:`../occ_command` for the full ``files_external:scan`` reference. A typical
239239
interval is every 15 minutes; adjust to balance freshness against server load.
240240

241+
.. note::
242+
If you are running Nextcloud AIO, the equivalent command is:
243+
244+
.. code-block:: console
245+
246+
sudo docker exec --user www-data -it nextcloud-aio-nextcloud php occ files_external:scan <mount_id>
247+
241248
Limitation: renames are not detected reliably
242249
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
243250

244251
Whenever Nextcloud rescans an external storage β€” whether via periodic cron
245-
(option B) or on direct access (option A setting **Once per direct access**) β€”
252+
(option B) or via the **Once per direct access** filesystem check frequency setting β€”
246253
the scanner cannot reliably detect that an entry was **renamed**. It sees the old
247254
name as deleted and the new name as a newly created entry. This causes
248255
**metadata loss**: all shares, tags, comments, and activity history associated

0 commit comments

Comments
Β (0)