Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Home Manager

When your host uses Home Manager as a NixOS module, the sidebar shows a Home Manager section. It lists the Home Manager options of the users on this host.

Requirements

  • Home Manager is imported as a NixOS module (home-manager.nixosModules.home-manager) in your host configuration.
  • Your user is set up in home-manager.users.<name>.

A standalone Home Manager setup (with its own home-manager switch) is not managed by the app.

Using it

The page works like the Options page: a search field, the area filter, Set in my configuration and Include <name> templates. Names are shown relative to the user, so you see programs.git.enable instead of home-manager.users.alice.programs.git.enable. If several users have Home Manager, choose the user in the list next to the search field.

Click an option to open its details. Changing it works exactly as described in Searching and changing options: choose a value or a Nix expression, a priority and, if needed, the host, then Stage change.

Where the settings go

Home Manager settings are written into the same generated files as your NixOS settings, as home-manager.users.<name>.…, and are applied with the next system rebuild. With a split layout they go into a home-manager/<name>/ folder next to the other parts, using the same layout inside it.