From b3258dece8af087fd471a4ca6b106d02c330dd37 Mon Sep 17 00:00:00 2001
From: Matthias Beyer <mail@beyermatthias.de>
Date: Thu, 12 Feb 2026 16:30:20 +0100
Subject: [PATCH] programs.radicle: Document how "rad auth" must be used with
 this

Signed-off-by: Matthias Beyer <mail@beyermatthias.de>
---
 modules/programs/radicle.nix | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

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";
               };