From 6f496236bc3241a9aa191d9e084f566771286d3a Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Fri, 26 Sep 2025 16:09:02 +0200 Subject: [PATCH] man: document --prompt-new-user which was added back in v256 --- man/homectl.xml | 17 ++++++++++++++--- 1 file changed, 14 insertions(+), 3 deletions(-) diff --git a/man/homectl.xml b/man/homectl.xml index 36b3bbfe9c8..83e2286acb7 100644 --- a/man/homectl.xml +++ b/man/homectl.xml @@ -205,6 +205,16 @@ + + + + If used in conjunction with firstboot and no regular user account + exists on the system so far the tool will interactively query for user information and create an + account. + + + + @@ -1424,9 +1434,10 @@ $ ssh lennart@targetsystem This command is supposed to be invoked during the initial boot of the system. It checks whether any regular home area exists so far, and if not queries the user interactively on the - console for user name and password and creates one. Alternatively, if one or more service credentials - whose name starts with home.create. are passed to the command (containing a user - record in JSON format) these users are automatically created at boot. + console for user name and password and creates one (only if is + specified). Alternatively, if one or more service credentials whose name starts with + home.create. are passed to the command (containing a user record in JSON format) + these users are automatically created at boot. This command is invoked by the systemd-homed-firstboot.service service unit. -- 2.47.3