From 6e3931c01f0e536deb85664b9096a89d7f54b0cf Mon Sep 17 00:00:00 2001
From: Benedikt Rips <benedikt.rips@gmail.com>
Date: Tue, 6 Jan 2026 13:49:15 +0100
Subject: [PATCH] keepassxc: add note about error message in the GUI

---
 modules/programs/keepassxc.nix | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/modules/programs/keepassxc.nix b/modules/programs/keepassxc.nix
index fd53c5cb..94bf5cf2 100644
--- a/modules/programs/keepassxc.nix
+++ b/modules/programs/keepassxc.nix
@@ -64,6 +64,13 @@ in
 
         See <https://github.com/keepassxreboot/keepassxc/blob/647272e9c5542297d3fcf6502e6173c96f12a9a0/src/core/Config.cpp#L49-L223>
         for the full list of options.
+
+        ::: {.note}
+        When the settings are non-empty, the configuration file will be linked
+        into the Nix store and KeePassXC will report an access error for its
+        configuration file. This is expected and can not be fixed in a way that
+        aligns with Home Manager's principles. See [#8257](https://github.com/nix-community/home-manager/issues/8257) for more details.
+        :::
       '';
     };