Declarative Dotfiles: Tame Your Dev Environment with Home Manager

If you've ever spent hours setting up a new machine, meticulously installing packages, tweaking config files, and syncing shell settings, only to forget a crucial alias six months later, you know the pain of environment management. What if you could declare your entire user environment—from apps and tools to editor configs and shell prompts—in a single, reproducible file?

That's the promise of Home Manager. It brings the power of Nix's declarative, reproducible package management to your personal $HOME directory.

What It Does

Home Manager is a tool built on the Nix package manager that lets you manage your user environment using a declarative configuration file (typically home.nix). Instead of manually running install commands and editing dotfiles, you describe the state you want: which packages to have, which configuration files to create, and which services to run. Home Manager then makes it so.

It can install and manage everything from core utilities (git, tmux) and programming languages (nodejs, rustc) to application configurations (Neovim, Alacritty, Zsh) and even systemd user services.

Why It's Cool

The magic is in the declarative model and Nix's underlying architecture. Once you define your home.nix, you can instantly apply it to a new system or user account. Home Manager will install any missing packages, generate all your dotfiles in the correct locations, and clean up anything you've removed from the config. It's like Infrastructure-as-Code, but for your dev environment.

This gives you atomic rollbacks. If an update breaks something, you can revert to the previous generation of your environment with a single command. Your configuration becomes portable and shareable—you can version control your home.nix file just like any other project code. It also solves "works on my machine" problems at the user level, ensuring your tools and settings are consistent across different machines.

How to Try It

You'll need Nix installed first. If you're on a standard Linux distribution or macOS, you can install Nix with:

sh <(curl -L https://nixos.org/nix/install)

Once Nix is ready, you can install Home Manager as a standalone tool (without a full NixOS system). The official README provides up-to-date installation commands, but it typically looks like this:

# Add the home-manager channel
nix-channel --add https://github.com/nix-community/home-manager/archive/master.tar.gz home-manager
nix-channel --update

# Install it
nix-shell '<home-manager>' -A install

After installation, you'll edit ~/.config/home-manager/home.nix. A simple starter config might look like:

{ config, pkgs, ... }:

{
  home.username = "jane";
  home.homeDirectory = "/home/jane";

  home.packages = [
    pkgs.htop
    pkgs.fzf
    pkgs.ripgrep
    pkgs.neovim
  ];

  programs.git = {
    enable = true;
    userName = "Jane Developer";
    userEmail = "[email protected]";
  };

  programs.zsh = {
    enable = true;
    ohMyZsh = {
      enable = true;
      plugins = [ "git" "docker" ];
      theme = "agnoster";
    };
  };

  home.stateVersion = "23.11";
}

Apply it with home-manager switch. Home Manager will get to work building and linking everything you specified.

Final Thoughts

Home Manager has a learning curve—you need to get comfortable with Nix's language and paradigm. But for developers who juggle multiple machines, crave reproducible setups, or are just tired of dotfile spaghetti, it's a game-changer. It turns environment setup from a manual art into a managed engineering task.

You don't have to go all-in immediately. Start by using it to manage a few non-critical packages and configs. Once you see it rebuild your perfect Neovim setup on a fresh laptop in minutes, you might just get hooked on the declarative life.

Follow for more cool projects: @githubprojects