Known issues

diff --git a/README.md b/README.md
index ede99ca13b2d6e18c5a3c50eb485b8fdb0281d44..621e8f18aebb0bf0868604f9f99154f8d88c8704 100644 (file)
--- a/README.md
+++ b/README.md
@@ -98,3 +98,20 @@ somewhere else. **If you don't want that, use `encryption="repokey"` at your con
 
 See [Repository Encryption](https://borgbackup.readthedocs.io/en/stable/quickstart.html#repository-encryption)
 for details.
+
+# Known issues
+
+Borger needs a better lock/session management to prevent errors like
+
+    Failed to create/acquire the lock (timeout)
+
+See also:
+
+- borg break-lock (before 1.1.0 in theory)
+- https://www.solved.tips/failed-create-acquire-lock/
+- https://github.com/rugk/borg-cron-helper
+- https://github.com/rugk/borg-cron-helper#local-lock-borg--v110
+- https://github.com/borgbackup/borg/issues/2306
+- https://github.com/borgbackup/borg/issues/813
+- https://github.com/borgbackup/borg/issues/2306
+- https://github.com/borgbackup/borg/issues/3191