Skip to content

Home Manager

Home manager provides a basic system for managing a user environment using the Nix package manager together with the Nix libraries found in Nixpkgs. It allows declarative configuration of user specific (non-global) packages and dotfiles.

Installation

  • First install nix
  • Add the appropriate Home Manager channel. If you are following Nixpkgs master or an unstable channel you can run
nix-channel --add https://github.com/nix-community/home-manager/archive/master.tar.gz home-manager
nix-channel --update

and if you follow a Nixpkgs version 23.11 channel you can run

nix-channel --add https://github.com/nix-community/home-manager/archive/release-23.11.tar.gz home-manager
nix-channel --update
  • Run the Home Manager installation command and create the first Home Manager generation:
nix-shell '<home-manager>' -A install

Once finished, Home Manager should be active and available in your user environment.

References