52 lines
1.3 KiB
Markdown
52 lines
1.3 KiB
Markdown
|
# Users
|
||
|
|
|
||
|
|
Users are a special case of [profiles](../profiles) that define system
|
||
|
|
users and [home-manager][home-manager] configurations. For your convenience,
|
||
|
|
home manager is wired in by default so all you have to worry about is declaring
|
||
|
|
your users. For a fully fleshed out example, check out the developers personal
|
||
|
|
[branch](https://github.com/nrdxp/nixflk/tree/nrd/users/nrd/default.nix).
|
||
|
|
|
||
|
|
## Basic Usage
|
||
|
|
`users/myuser/default.nix`:
|
||
|
|
```nix
|
||
|
|
{ ... }:
|
||
|
|
{
|
||
|
|
users.users.myuser = {
|
||
|
|
isNormalUser = true;
|
||
|
|
};
|
||
|
|
|
||
|
|
home-manager.users.myuser = {
|
||
|
|
programs.mpv.enable = true;
|
||
|
|
};
|
||
|
|
}
|
||
|
|
|
||
|
|
```
|
||
|
|
|
||
|
|
## External Usage
|
||
|
|
You can easily use the defined home-manager configurations outside of NixOS
|
||
|
|
using the `hmActivations` meta-package defined in the flakes `legacyPackages`
|
||
|
|
output. The [flk](../doc/flk) helper script makes this even easier.
|
||
|
|
|
||
|
|
This is great for keeping your environment consistent across Unix systems,
|
||
|
|
including OSX.
|
||
|
|
|
||
|
|
### From within the projects devshell:
|
||
|
|
```sh
|
||
|
|
# builds the nixos user defined in the NixOS host
|
||
|
|
flk home NixOS nixos
|
||
|
|
|
||
|
|
# build and activate
|
||
|
|
flk home NixOS nixos switch
|
||
|
|
```
|
||
|
|
|
||
|
|
### Manually from outside the project:
|
||
|
|
```sh
|
||
|
|
# build
|
||
|
|
nix build "github:nrdxp/nixflk#hmActivationPackages.NixOS.nixos"
|
||
|
|
|
||
|
|
# activate
|
||
|
|
./result/activate && unlink result
|
||
|
|
```
|
||
|
|
|
||
|
|
[home-manager]: https://nix-community.github.io/home-manager
|