From 92418883dca2595e5cab9efe18c44b1ab28f8536 Mon Sep 17 00:00:00 2001
From: Thomas Waldmann <tw@waldmann-edv.de>
Date: Fri, 10 Oct 2025 14:57:25 +0200
Subject: [PATCH] docs: how to debug borg mount, fixes #5461

---
 src/borg/archiver.py | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/src/borg/archiver.py b/src/borg/archiver.py
index a85e6780e..2114d33f9 100644
--- a/src/borg/archiver.py
+++ b/src/borg/archiver.py
@@ -3269,6 +3269,13 @@ class Archiver:
 
         When running in the foreground, ^C/SIGINT cleanly unmounts the filesystem,
         but other signals or crashes do not.
+
+        Debugging:
+
+        ``borg mount`` usually daemonizes and the daemon process sends stdout/stderr
+        to /dev/null. Thus, you need to either use ``-f / --foreground`` to make it stay
+        in the foreground and not daemonize, or use ``BORG_LOGGING_CONF`` to reconfigure
+        the logger to output to a file.
         """)
 
         if parser.prog == 'borgfs':