From 11626a4383b458f8dc5ea3237eaa04e8ab1912f3 Mon Sep 17 00:00:00 2001
From: "Benedikt M. Rips" <benedikt.rips@gmail.com>
Date: Fri, 15 Aug 2025 05:46:10 +0200
Subject: [PATCH] keepassxc: note the manifest installation conflict (#7675)

---
 modules/programs/keepassxc.nix | 24 ++++++++++++++++++++++--
 1 file changed, 22 insertions(+), 2 deletions(-)

diff --git a/modules/programs/keepassxc.nix b/modules/programs/keepassxc.nix
index 6b6c63380..fd53c5cb4 100644
--- a/modules/programs/keepassxc.nix
+++ b/modules/programs/keepassxc.nix
@@ -17,7 +17,27 @@ in
   ];
 
   options.programs.keepassxc = {
-    enable = lib.mkEnableOption "keepassxc";
+    enable = lib.mkEnableOption "keepassxc" // {
+      description = ''
+        Whether to enable KeePassXC.
+
+        ::: {.note}
+        When this flag is set, KeePassXC' builtin native messaging manifest for
+        communication with its browser extension is automatically installed.
+        This conflicts with KeePassXC' builtin installation mechanism. To
+        prevent error messages, either set
+        {option}`programs.keepassxc.settings.Browser.UpdateBinaryPath` to
+        `false`, or untick the checkbox
+
+          Application Settings/
+            Browser Integration/
+              Advanced/
+                Update native messaging manifest files at startup
+
+        in the GUI.
+        :::
+      '';
+    };
 
     package = lib.mkPackageOption pkgs "keepassxc" { nullable = true; };
 
@@ -52,7 +72,7 @@ in
       default = false;
       example = true;
       description = ''
-        Whether to start Keepassxc automatically on login through the XDG autostart mechanism.
+        Whether to start KeePassXC automatically on login through the XDG autostart mechanism.
       '';
     };
   };