aboutsummaryrefslogtreecommitdiffstats
path: root/docs/USERGUIDE.md
diff options
context:
space:
mode:
authorChristophe Besson <cbesson@gmail.com>2026-10-12 00:17:32 +0200
committerChristophe Besson <cbesson@gmail.com>2026-10-12 00:17:32 +0200
commit14911aae21ec4975f7a805b91e3c4867cb41974b (patch)
tree8c00230a88053905fd77938f3a9539efeb4c3094 /docs/USERGUIDE.md
parentf6f107e02c7a4aa7326c9a82310a239327d81ed6 (diff)
downloadmeshbay-14911aae21ec4975f7a805b91e3c4867cb41974b.tar.gz
feat: let the operator pause and resume a root's indexing (MNP 6.2)
A whole-root walk now checks its root before every file: removed or ejected, it stops instead of reading the drive to the end; paused, it finishes from the hash cache alone. A paused root is not watched, not swept by reconcile and survives a restart (roster), its indexed files stay served. Resume runs the reconcile sweep over the root, so entries and their enrichment are kept. Signed root_pause / root_resume over MNP, loopback routes, CLI `root pause|resume`, a pause button on the indexing dock and pause/resume in the roots table of Group settings. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Diffstat (limited to 'docs/USERGUIDE.md')
-rw-r--r--docs/USERGUIDE.md8
1 files changed, 8 insertions, 0 deletions
diff --git a/docs/USERGUIDE.md b/docs/USERGUIDE.md
index 5649b30..42103d6 100644
--- a/docs/USERGUIDE.md
+++ b/docs/USERGUIDE.md
@@ -695,6 +695,13 @@ catalogued.
Group → Settings has the re-check interval and how long the node waits after a
file changes before indexing it. Members see indexing progress while it runs.
+**Pausing.** Indexing a large drive takes hours. The pause button on the
+indexing band, or **Pause indexing** beside the directory in Group → Settings,
+stops it at the next file. The files already indexed stay visible to members.
+Nothing else in that directory is indexed until you click **Resume indexing**,
+not even a file a member uploads into it, and the pause survives a restart.
+Resuming picks up where it stopped: files already indexed are not read again.
+
One thing that surprises people: **two identical files in one group are one
entry**, because a file is identified by its content. A scan that reports ten
files and indexes nine has not lost anything.
@@ -1058,6 +1065,7 @@ meshbay-node reset erase all node state (destructive)
meshbay-node group list|add|remove groups this node hosts
meshbay-node root list|add|remove|set directories in a group
meshbay-node root eject|plug removable drives
+meshbay-node root pause|resume stop and restart a directory's indexing
meshbay-node gek init|rotate the group's encryption key
meshbay-node operator pair authorise a browser