foodogsquared/nixos-config
1
0
Fork 0
mirror of https://github.com/foo-dogsquared/nixos-config.git synced 2025-01-31 16:57:55 +00:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity
bd0f0a7baf
nixos-config/docs/content/en-US/project-specific-setup/declarative-user-management/index.adoc

2.0 KiB
Raw Blame History

title: Declarative user management --- = Declarative user management

Similarly to Declarative host management, this project also provides a way to declare home-manager users. The users.toml sits in the project root expecting certain data. Similar to images.toml, it expects a table of users with each representing one of the users from github:{github-repo}[./users/home-manager/, path=./users/home-manager/, rev=master]. These are then included as part of homeConfigurations for easier installation with the standalone home-manager tool. Of which they are then included as part of deploy nodes for deploy-rs (also for easier deployment).

Here’s an example user with complete schema.

A user with complete schema
[foo-dogsquared]
system = "x86_64-linux"
home-manager-channel = "home-manager-23.05"
home-directory = "/home/foo-dogsquared"
username = "foodogsquared"

[foo-dogsquared.deploy]
hostname = "local.foodogsquared.one"
ssh-user = "admin"
profile = "foodogsquared"
fast-connection = true
auto-rollback = true
magic-rollback = true
remote-build = true

  • system contains the platform of the home-manager user. This is mainly used to indicate the platform used for the nixpkgs repository.

  • home-manager-channel contains the home-manager channel to be used. The value should be one of the home-manager channel that is imported into this flake. By default, it sets the home-manager channel at home-manager which is pointed at the unstable channel.

  • home-directory is the associated home directory of the home-manager. It is set for config.home.directory at the home-manager configuration. By default, it will be set at /home/$USERNAME.

  • username is the username of the home-manager user to be used for config.home.username at the home-manager configuration. If unset, it will use the table key. In the above example, the unset value would be foo-dogsquared.

  • deploy is pretty similar to the previous configuration setting that it sets certain options for deploy-rs.