axeman/pub-solar-os
1
0
Fork 0
forked from pub-solar/os
Code Issues Pull requests Packages Projects Releases Wiki Activity
pub-solar-os/users/README.md
Timothy DeHerrera bf34d2071f
doc: new mdbook documentation
2021-02-14 02:46:05 -07:00

1.3 KiB
Raw Blame History

Users

Users are a special case of profiles that define system users and 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.

Basic Usage

users/myuser/default.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 helper script makes this even easier.

This is great for keeping your environment consistent across Unix systems, including OSX.

From within the projects devshell:

# 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:

# build
nix build "github:nrdxp/nixflk#hmActivationPackages.NixOS.nixos"

# activate
./result/activate && unlink result