diff --git a/modules/programs/radicle.nix b/modules/programs/radicle.nix
index 3fd51e35..38334bb9 100644
--- a/modules/programs/radicle.nix
+++ b/modules/programs/radicle.nix
@@ -136,7 +136,13 @@ in
             node = {
               alias = mkOption {
                 type = str;
-                description = "Human readable alias for your node.";
+                description = ''
+                  Human readable alias for your node.
+
+                  When running 'rad auth' for the first time, you need to use the exact same alias,
+                  otherwise 'rad auth' will fail because it cannot write the configuration
+                  file in your home directory (which is generated by nix).
+                '';
                 default = config.home.username;
                 defaultText = lib.literalExpression "config.home.username";
               };