From e1e36ed848e9d2a5df82ff4b8a3433592cc61e4d Mon Sep 17 00:00:00 2001
From: Srigovind Nayak <5201843+konidev20@users.noreply.github.com>
Date: Sat, 16 May 2026 18:07:42 +0530
Subject: [PATCH] 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.
---
 doc/050_restore.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/doc/050_restore.rst b/doc/050_restore.rst
index 3c92fcc98..d388ab16c 100644
--- a/doc/050_restore.rst
+++ b/doc/050_restore.rst
@@ -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