User management - Revision history

Pigs: add user to group section

2025-05-22T19:18:02Z

add user to group section

← Older revision		Revision as of 19:18, 22 May 2025
Line 40:		Line 40:

	SSH authentication can be customized by setting the {{nixos:option\|users.users.*.openssh.authorizedKeys\|users.users.<name>.openssh.authorizedKeys}} option.		SSH authentication can be customized by setting the {{nixos:option\|users.users.*.openssh.authorizedKeys\|users.users.<name>.openssh.authorizedKeys}} option.

			== Adding User to a group ==

			Users can be added to a group by setting the {{nixos:option\|users.users.*.extraGroups\|users.users.<name>.extraGroups}} option. For example:

			{{file\|/etc/nixos/configuration.nix\|nix\|
			<nowiki>
			users.users.alice = {
			...
			extraGroups = [ "wheel" "networkmanager" ];
			};
			</nowiki>
			}}

	== Home Manager ==		== Home Manager ==

Pigs: Add category configuration and nixos manual

2025-05-18T05:21:48Z

Add category configuration and nixos manual

← Older revision		Revision as of 05:21, 18 May 2025
Line 44:		Line 44:

	For additional user environment configuration, including management of dotfiles, shell settings, and user-specific packages, consider using [[Home Manager]].		For additional user environment configuration, including management of dotfiles, shell settings, and user-specific packages, consider using [[Home Manager]].

			[[Category:Configuration]]
			[[Category:NixOS Manual]]

Pigs: Use nixos:options to be able to render

2025-05-15T20:05:41Z

Use nixos:options to be able to render <name>

← Older revision		Revision as of 20:05, 15 May 2025
Line 11:		Line 11:
	User passwords can be defined declaratively by specifying a hashed password in the system configuration. To generate a password hash, run the following command and enter the desired password when prompted: <code>mkpasswd</code>		User passwords can be defined declaratively by specifying a hashed password in the system configuration. To generate a password hash, run the following command and enter the desired password when prompted: <code>mkpasswd</code>

	The resulting hash can then be assigned ~~to <code>hashedPassword</code>, <code>initialHashedPassword</code>, or <code>hashedPasswordFile</code> options within the user definition. For more information, refer~~ to {{nixos:option\|users.users..hashedPassword}}. Example:		The resulting hash can then be assigned to {{nixos:option\|users.users..hashedPassword\|hashedPassword, initialHashedPassword, or hashedPasswordFile}} options within the user definition. Example:

	{{file\|/etc/nixos/configuration.nix\|nix\|		{{file\|/etc/nixos/configuration.nix\|nix\|
Line 24:		Line 24:
	== User Home Directories ==		== User Home Directories ==

	By default, user home directories are created at <code>/home/<username></code> when {{nixos:option\|users.users.*.isNormalUser}} is true.		By default, user home directories are created at <code>/home/<username></code> when {{nixos:option\|users.users.*.isNormalUser\|users.users.<name>.isNormalUser}} is true.

	Custom home directories can be set via the <code>home</code> option:		Custom home directories can be set via the <code>home</code> option:
Line 33:		Line 33:
	{{main\|Command Shell}}		{{main\|Command Shell}}

	Login shells can be customized by setting the {{nixos:option\|users.users.*.shell}} option.		Login shells can be customized by setting the {{nixos:option\|users.users.*.shell\|users.users.<name>.shell}} option.

	== User SSH Authorized Keys ==		== User SSH Authorized Keys ==
Line 39:		Line 39:
	{{main\|SSH public key authentication#SSH server configuration}}		{{main\|SSH public key authentication#SSH server configuration}}

	SSH authentication can be customized by setting the {{nixos:option\|users.users.*.openssh.authorizedKeys}} option.		SSH authentication can be customized by setting the {{nixos:option\|users.users.*.openssh.authorizedKeys\|users.users.<name>.openssh.authorizedKeys}} option.

	== Home Manager ==		== Home Manager ==

	For additional user environment configuration, including management of dotfiles, shell settings, and user-specific packages, consider using [[Home Manager]].		For additional user environment configuration, including management of dotfiles, shell settings, and user-specific packages, consider using [[Home Manager]].

Pigs: Create user management page

2025-05-15T18:43:19Z

Create user management page

New page

On NixOS, system users and their properties are declaratively managed through the {{nixos:option|users.users}} and {{nixos:option|users.groups}} options in the NixOS configuration.

For additional details, refer to {{NixOS Manual|anchor=#sec-user-management|name=NixOS Manual: Chapter - User Management}}.

{{note|The option <code>users.users</code> has an alias <code>users.extraUsers</code>, and similarly, <code>users.groups</code> can also be referred to as <code>users.extraGroups</code>.}}

== User Password ==

{{warning|Avoid publishing hashed passwords, as they still pose a security risk if exposed. Consider using [[Agenix]] or [https://github.com/Mic92/sops-nix sops-nix] to manage passwords.}}

User passwords can be defined declaratively by specifying a hashed password in the system configuration. To generate a password hash, run the following command and enter the desired password when prompted: <code>mkpasswd</code>

The resulting hash can then be assigned to <code>hashedPassword</code>, <code>initialHashedPassword</code>, or <code>hashedPasswordFile</code> options within the user definition. For more information, refer to {{nixos:option|users.users.*.*hashedPassword}}. Example:

{{file|/etc/nixos/configuration.nix|nix|
<nowiki>
users.users.alice = {
...
hashedPassword = "$y$j9T$VQsJBEktGmRh14iCMzZ4v1$oN/Gb8KkSOvial2QaECWu1Oo/voyJCOZdX1nXAyGlt6";
};
</nowiki>
}}

== User Home Directories ==

By default, user home directories are created at <code>/home/<username></code> when {{nixos:option|users.users.*.isNormalUser}} is true.

Custom home directories can be set via the <code>home</code> option:
<code> users.users.alice.home = "/data/alice"; </code>

== User Shell Configuration ==

{{main|Command Shell}}

Login shells can be customized by setting the {{nixos:option|users.users.*.shell}} option.

== User SSH Authorized Keys ==

{{main|SSH public key authentication#SSH server configuration}}

SSH authentication can be customized by setting the {{nixos:option|users.users.*.openssh.authorizedKeys}} option.

== Home Manager ==

For additional user environment configuration, including management of dotfiles, shell settings, and user-specific packages, consider using [[Home Manager]].