doc: note that mountpoint must not overlap the repository

Document the new restriction added so users encountering the error
message have a reference, and so the constraint is visible before they
hit it.
This commit is contained in:
Srigovind Nayak 2026-05-16 18:07:42 +05:30
parent a37010a825
commit e1e36ed848
No known key found for this signature in database
GPG key ID: A5A62F4DD79FB9E5

View file

@ -208,6 +208,12 @@ command needs to be in the ``PATH``. On macOS, you need `FUSE-T
<https://www.fuse-t.org/>`__ or `FUSE for macOS <https://osxfuse.github.io/>`__.
On FreeBSD, you may need to install FUSE and load the kernel module (``kldload fuse``).
.. note:: The mountpoint must not overlap the local repository directory.
Using the repository directory itself, a subdirectory of it, or a parent
of it as the mountpoint causes the FUSE server to read its own backend
files through the new mount and deadlock the kernel. ``restic mount``
detects this and refuses such mountpoints.
Restic supports storage and preservation of hard links. However, since
hard links exist in the scope of a filesystem by definition, restoring
hard links from a FUSE mount should be done by a program that preserves