From 59aabcd3db975f9ff7a5df918ad17284361723c0 Mon Sep 17 00:00:00 2001
From: rcerc <88944439+rcerc@users.noreply.github.com>
Date: Mon, 25 Aug 2025 11:13:37 -0400
Subject: [PATCH] swaylock: document how to fix PAM on non-NixOS

Fixes #7717.
---
 modules/programs/swaylock.nix | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/modules/programs/swaylock.nix b/modules/programs/swaylock.nix
index 340663a65..063122ae4 100644
--- a/modules/programs/swaylock.nix
+++ b/modules/programs/swaylock.nix
@@ -33,6 +33,13 @@ in
         ```nix
         security.pam.services.swaylock = {};
         ```
+
+        On non-NixOS, it is easiest to avoid incompatibility involving PAM by
+
+        1. stopping Home Manager from installing swaylock by setting
+           {option}`programs.swaylock.package` to `null`; and
+
+        2. instead installing swaylock from your distribution's repository.
       '';
     };