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.
+        :::
       '';
     };