nixos-config/users/README.adoc

= User-specific configuration
:toc:

This is where user-specific configurations comes in.
Similar to modules, the top-level of this directory contains users for various config types (e.g., home-manager, NixOS).

As such, files put in here are only a part of the total sum of configuration (whether it is a home-manager configuration or a NixOS system).
It shouldn't fully configure their respective system and should be put as a host configuration otherwise.

Users shouldn't also have their own set of modules similar to this project's own modules.
They should be imported as a profile or hardcoded in the user config.

Take note of the following structure:

[source, tree]
----
users/
├── home-manager/
│   ├── foo-dogsquared/
│   ├── harepoint/
│   └── polski/
├── nixos/
│   ├── foo-dogsquared/
│   ├── harepoint/
│   └── vmguest/
└── README.adoc
----

This folder is to be expected to be imported through `lib.filesToAttr` from the link:../lib/default.nix[`../lib/default.nix`].

There are conventions for setting in each user type.

* For NixOS user configuration, it is expect to only have one user with their respective user-specific configuration.
This includes user-specific packages, home-manager-specific configuration footnote:[Though, it is encouraged to put it as a separate home-manager user configuration if it's big enough.], and so forth.
If you want to set users from the host, see link:../hosts/README.adoc[Host-specific configurations] for more details.

* home-manager users are just home-manager configurations (i.e., `$XDG_CONFIG_HOME/nix/home.nix`).
Take note that it is assumed that my link:../modules/home-manager/[own home-manager modules] are imported.
Update documentation 2021-12-21 06:29:27 +00:00			`= User-specific configuration`
Update config 2021-11-27 08:04:01 +00:00			`:toc:`

			`This is where user-specific configurations comes in.`
docs: update 2022-09-19 02:56:06 +00:00			`Similar to modules, the top-level of this directory contains users for various config types (e.g., home-manager, NixOS).`

			`As such, files put in here are only a part of the total sum of configuration (whether it is a home-manager configuration or a NixOS system).`
			`It shouldn't fully configure their respective system and should be put as a host configuration otherwise.`

			`Users shouldn't also have their own set of modules similar to this project's own modules.`
			`They should be imported as a profile or hardcoded in the user config.`
Update user-specific config Oh no, now I'm content with creating my own framework instead of using something like digga or flake-utils. 2021-11-29 05:30:57 +00:00
Update documentation 2021-12-21 06:29:27 +00:00			`Take note of the following structure:`
Update user-specific config Oh no, now I'm content with creating my own framework instead of using something like digga or flake-utils. 2021-11-29 05:30:57 +00:00
Update documentation 2021-12-21 06:29:27 +00:00			`[source, tree]`
Update user-specific config Oh no, now I'm content with creating my own framework instead of using something like digga or flake-utils. 2021-11-29 05:30:57 +00:00			`----`
Update documentation 2021-12-21 06:29:27 +00:00			`users/`
			`├── home-manager/`
			`│ ├── foo-dogsquared/`
			`│ ├── harepoint/`
			`│ └── polski/`
			`├── nixos/`
			`│ ├── foo-dogsquared/`
			`│ ├── harepoint/`
			`│ └── vmguest/`
			`└── README.adoc`
Update home-manager modules and related configs 2021-11-29 09:56:24 +00:00			`----`

docs: update 2022-09-19 02:56:06 +00:00			This folder is to be expected to be imported through `lib.filesToAttr` from the link:../lib/default.nix[`../lib/default.nix`].

Update documentation 2021-12-21 06:29:27 +00:00			`There are conventions for setting in each user type.`
Update home-manager modules and related configs 2021-11-29 09:56:24 +00:00
Update documentation 2021-12-21 06:29:27 +00:00			`* For NixOS user configuration, it is expect to only have one user with their respective user-specific configuration.`
docs: update 2022-09-19 02:56:06 +00:00			`This includes user-specific packages, home-manager-specific configuration footnote:[Though, it is encouraged to put it as a separate home-manager user configuration if it's big enough.], and so forth.`
Update documentation 2021-12-21 06:29:27 +00:00			`If you want to set users from the host, see link:../hosts/README.adoc[Host-specific configurations] for more details.`
Update home-manager modules and related configs 2021-11-29 09:56:24 +00:00
Update documentation 2021-12-21 06:29:27 +00:00			* home-manager users are just home-manager configurations (i.e., `$XDG_CONFIG_HOME/nix/home.nix`).
docs: update 2022-11-12 02:37:17 +00:00			`Take note that it is assumed that my link:../modules/home-manager/[own home-manager modules] are imported.`