Home Manager: Difference between revisions

From NixOS Wiki
imported>Luis-Hebendanz
mNo edit summary
imported>Makefu
add FAQ
Line 57: Line 57:
* [https://git.sr.ht/~ben/config bsima's configs]
* [https://git.sr.ht/~ben/config bsima's configs]


=== Alternatives ===
== FAQ ==
=== I cannot set gnome themes via home-manager ===
You will have to add
<syntaxHighlight lang=nix>
services.dbus.packages = with pkgs; [ gnome3.dconf ];
</syntaxHighlight>
to your system configuration. ( [https://old.reddit.com/r/NixOS/comments/b255k5/home_manager_cannot_set_gnome_themes/ Source] )
== Alternatives ==
* [[Wrappers vs. Dotfiles]] shows how (per-user) wrapper scripts can be used in place of dotfiles in the user's home directory
* [[Wrappers vs. Dotfiles]] shows how (per-user) wrapper scripts can be used in place of dotfiles in the user's home directory

Revision as of 17:44, 17 March 2019

Home Manager is a basic system for managing a user environment using the Nix package manager together with the Nix libraries found in Nixpkgs. Before attempting to use Home Manager please read the warning.

Configuration

Home Manager can be configured in ~/.config/nixpkgs/home.nix or inside configuration.nix.

For the latter, add the following to your config. Note: fetchTarball does not check the integrity of the downloaded package.

  imports = [
    ...
    "${builtins.fetchTarball https://github.com/rycee/home-manager/archive/master.tar.gz}/nixos"
  ];
  home-manager.users.my_username = { ... }

For a more secure version:

let
  home-manager = builtins.fetchGit {
    url = "https://github.com/rycee/home-manager.git";
    rev = "dd94a849df69fe62fe2cb23a74c2b9330f1189ed"; # CHANGEME 
    ref = "release-18.09";
  };
in
{
    imports = [
      "${home-manager}/nixos"
   ];

    home-manager.users.my_username = { ... }
}

Managing your dotfiles

Home Manager has options to configure many common tools. As an example, adding the following

  programs.git = {
    enable = true;
    userName  = "my_git_username";
    userEmail = "my_git_username@gmail.com";
  };

will make Home Manager generate a .config/git/config file for you.

Even for programs for which Home Manager doesn't have configuration options, you can use it to manage your dotfiles, e.g.

  home.file.".config/i3blocks/config".source = "${my-dotfile-dir}/i3blocks.conf"

This will create a symlink .config/i3blocks/config.

Examples

FAQ

I cannot set gnome themes via home-manager

You will have to add

services.dbus.packages = with pkgs; [ gnome3.dconf ];

to your system configuration. ( Source )

Alternatives

  • Wrappers vs. Dotfiles shows how (per-user) wrapper scripts can be used in place of dotfiles in the user's home directory