foodogsquared/nixos-config
1
0
Fork 0
mirror of https://github.com/foo-dogsquared/nixos-config.git synced 2025-01-31 10:58:02 +00:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity

docs: update hosts README

Browse Source
This commit is contained in:
Gabriel Arazas 2024-03-31 23:43:33 +08:00
parent d64df9bbc2
commit d6e2920f76
No known key found for this signature in database
GPG Key ID: 62104B43D00AA360
1 changed files with 6 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
configs/nixos/README.adoc
View File

@ -28,19 +28,19 @@ For managing users, there are multiple ways to manage them within this project:
* If you intend to import users from the link:./_users[`./_users`], you can simply import them through `imports` in the system module. * If you intend to import users from the link:./_users[`./_users`], you can simply import them through `imports` in the system module.
+ +
-- --
For a convenient option, there is the function `getUser` defined from the link:../../lib/private.nix[private custom library]. For a convenient option, there is the function `getUser` defined from the link:../../lib/default.nix[custom library].
You can use it as follows: You can use it as follows:
[source, nix] [source, nix]
---- ----
imports = [ imports = [
(lib.private.getUser "nixos" "foo-dogsquared") (foodogsquaredLib.getUser "nixos" "foo-dogsquared")
(lib.private.getUser "nixos" "polaski") (foodogsquaredLib.getUser "nixos" "polaski")
]; ];
---- ----
-- --
* You could also easily map link:../home-manager[one of my home-manager configurations] into one of the users for a NixOS system with `lib.private.mapHomeManagerUser` which accepts two arguments: a name from of the home-manager user folder and the user config as if configuration with `users.users.<name>`. * You could also easily map link:../home-manager[one of my home-manager configurations] into one of the users for a NixOS system with `foodogsquaredUtils.mapHomeManagerUser` which accepts two arguments: a name from of the home-manager user folder and the user config as if configuration with `users.users.<name>`.
However, this is only acceptable if the imported home-manager configuration only requires the baseline home-manager configuration and nothing else. However, this is only acceptable if the imported home-manager configuration only requires the baseline home-manager configuration and nothing else.
+ +
-- --
@ -48,7 +48,7 @@ Here's an example to easily get my main home-manager config to be one of the use
[source, nix] [source, nix]
---- ----
lib.private.mapHomeManagerUser "foo-dogsquared" { foodogsquaredUtils.mapHomeManagerUser "foo-dogsquared" {
extraGroups = [ "audio" "docker" ]; extraGroups = [ "audio" "docker" ];
password = "what"; password = "what";
createHome = true; createHome = true;
@ -58,7 +58,7 @@ lib.private.mapHomeManagerUser "foo-dogsquared" {
-- --
* For more comprehensive home-manager users that requires additional home-manager modules outside of the baseline home-manager configuration, you'll have to use `setups.nixos.configs.<name>.homeManagerUsers.users` from the declarative hosts config. * For more comprehensive home-manager users that requires additional home-manager modules outside of the baseline home-manager configuration, you'll have to use `setups.nixos.configs.<name>.homeManagerUsers.users` from the declarative hosts config.
Similar to `mapHomeManagerUser` library function, this takes care to map the home-manager user into a NixOS user with a home-manager configuration but it does more. Similar to `mapHomeManagerUser` library function, this takes care of mapping the home-manager user into a NixOS user with a home-manager configuration but it does more.
It also imports all of the overlays and modules from the declarative home-manager user config. It also imports all of the overlays and modules from the declarative home-manager user config.
+ +
-- --