<a href="https://github.com/nix-community/home-manager" target="_blank" rel="nofollow noopener noreferrer">home-manager</a>は、Nixを使ってユーザーの環境を管理するためのツールです。NixOSの仕組みを流用して作られているため、設定の書き方や使い方はNixOSに似ています。
基本機能として以下の機能を持っています。
<ul data-line="3" class="code-line">
<li data-line="3" class="code-line">宣言的なパッケージ導入
<ul data-line="4" class="code-line">
<li data-line="4" class="code-line">内部では <code>nix-env</code> あるいは <code>nix profile</code> で管理され、これらで導入したパッケージと同じ扱いになります</li>
</ul>
</li>
<li data-line="5" class="code-line">Nix storeからのシンボリックリンク生成
<ul data-line="6" class="code-line">
<li data-line="6" class="code-line">いわゆるdotfilesのようなことができます。chezmoiの振る舞いに近いと思います</li>
</ul>
</li>
<li data-line="7" class="code-line">環境変数管理
<ul data-line="8" class="code-line">
<li data-line="8" class="code-line">出力されるソースは下記のパスのいずれかにあるので、home-managerでシェルの設定を管理してない場合は自前で読み込む必要があります
<ul data-line="9" class="code-line">
<li data-line="9" class="code-line"><code>~/.nix-profile/etc/profile.d/hm-session-vars.sh</code></li>
<li data-line="10" class="code-line"><code>~/.local/state/nix/profiles/profile/etc/profile.d/hm-session-vars.sh</code></li>
<li data-line="11" class="code-line">
<code>/etc/profiles/per-user/${id -nu}/etc/profile.d/hm-session-vars.sh</code> 
更にNixOSと同様に、設定をNixで生成する機能も持っています。</li>
</ul>
</li>
</ul>
</li>
</ul>
<h1 id="%E5%B0%8E%E5%85%A5" data-line="14" class="code-line">
<a class="header-anchor-link" href="#%E5%B0%8E%E5%85%A5" aria-hidden="true"></a> 導入</h1>
上のリンクから辿れるマニュアルに全て書いてあるので、その通りに行います。 
本記事ではstandalone版を導入します。事前に、experimentalではあるものの事実上の標準になっているNix Flakesの機能を有効化しておくのをおすすめします。<code>~/.config/nix/nix.conf</code> に以下の記述を加えると有効化されます。
<div class="code-block-container"><pre><code class="code-line" data-line="19">experimental-features = nix-command flakes
</code></pre></div>Nix Flakes版は以下のコマンドを叩くだけで完了します。
<div class="code-block-container"><pre><code class="code-line" data-line="25">$ nix run home-manager/master -- init --switch
</code></pre></div>Nix Flakesを使わない場合はhome-managerのchannelを追加で導入した上で <code>nix-shell</code> 上でhome-managerを走らせます。
<div class="code-block-container"><pre><code class="code-line" data-line="32">$ nix-channel --add https://github.com/nix-community/home-manager/archive/master.tar.gz home-manager
$ nix-channel --update
$ nix-shell -p home-manager
$ home-manager init --switch
</code></pre></div><code>~/.config/home-manager</code> (initに引数を渡せばパスの変更が可能)以下にテンプレートが吐き出された後にプロファイルの切り替えが走ります。 
必要であればnix-shellから抜けたりシェルの再起動をした後、グローバルで <code>home-manager</code> コマンドが使えるようになれば導入成功です。
<h1 id="%E6%AC%A1%E3%81%AB%E3%82%84%E3%82%8B%E3%81%93%E3%81%A8" data-line="42" class="code-line">
<a class="header-anchor-link" href="#%E6%AC%A1%E3%81%AB%E3%82%84%E3%82%8B%E3%81%93%E3%81%A8" aria-hidden="true"></a> 次にやること</h1>
基本的に、生成された <code>home.nix</code> を編集し <code>home-manager switch</code> コマンドを叩くという操作を繰り返します。壊れた時に戻す操作を行いやすくするためにバージョン管理を行うことを強く推奨します。 
パッケージ導入かシンボリックリンク生成のいずれかを行うのをおすすめします。
<h2 id="%E3%83%91%E3%83%83%E3%82%B1%E3%83%BC%E3%82%B8%E5%B0%8E%E5%85%A5" data-line="46" class="code-line">
<a class="header-anchor-link" href="#%E3%83%91%E3%83%83%E3%82%B1%E3%83%BC%E3%82%B8%E5%B0%8E%E5%85%A5" aria-hidden="true"></a> パッケージ導入</h2>
<code>home.nix</code> の <code>home.packages</code> 以下に記述した式の通りにパッケージを導入する機能です。
生成された <code>home.nix</code> の <code># pkgs.hello</code> のコメントアウトを外します。
<div class="code-block-container"><pre class="diff-highlight "><code class="diff-highlight code-line" data-line="51">--- a/home.nix
+++ b/home.nix
@@ -20,7 +20,7 @@
 home.packages = [
 # # Adds the 'hello' command to your environment. It prints a friendly
 # # "Hello, world!" when run.
- # pkgs.hello
+ pkgs.hello
 
 # # It is sometimes useful to fine-tune packages, for example, by applying
 # # overrides. You can do that directly here, just don't forget the
</code></pre></div>その上で <code>home-manager switch</code> を実行すると <code>hello</code> コマンドが使えるようになります。 
コメントアウトを戻した上で再び <code>home-manager switch</code> を実行すると <code>hello</code> コマンドが使えなくなります。 
パッケージの導入状況が宣言した通りに展開されるため、考えるべき状態が減り便利です。
<h2 id="%E3%82%B7%E3%83%B3%E3%83%9C%E3%83%AA%E3%83%83%E3%82%AF%E3%83%AA%E3%83%B3%E3%82%AF%E7%94%9F%E6%88%90" data-line="69" class="code-line">
<a class="header-anchor-link" href="#%E3%82%B7%E3%83%B3%E3%83%9C%E3%83%AA%E3%83%83%E3%82%AF%E3%83%AA%E3%83%B3%E3%82%AF%E7%94%9F%E6%88%90" aria-hidden="true"></a> シンボリックリンク生成</h2>
<code>home.nix</code> の <code>home.file</code> 以下に記述した式の通りにホームディレクトリ以下にシンボリックリンクを生成する機能です。
例えば、以下の記述を行うと、Emacsのddskkというパッケージ用に、nixpkgsにあるSKK辞書を使うように指示する設定が <code>$HOME/.skk.el</code> に出力されます。
<div class="code-block-container"><pre class="language-nix"><code class="language-nix code-line" data-line="74">home.file = {
 ".skk.el".text = ''
 (setq skk-large-jisyo "${pkgs.skkDictionaries.l}/share/skk/SKK-JISYO.L")
 '';
};
</code></pre></div>derivationの出力(つまりパッケージの中身)を含むNix store内のファイルを配置することもできます。
<div class="code-block-container"><pre class="language-nix"><code class="language-nix code-line" data-line="84">home.file = {
 ".vimrc".source = ./vimrc;
 "bin/git-save".source = pkgs.writeShellScript "git-save" ''
 git add -A ; git commit -m save
 '';
};
</code></pre></div>このように、Nixの評価結果を利用できるのが、他のdotfiles managerとは異なる特色です。慣れるとできることの幅がどんどん拡がっていくので強力だと思います。
<h1 id="%E5%BF%9C%E7%94%A8%3A%E5%AE%A3%E8%A8%80%E7%9A%84%E3%81%AA%E8%A8%AD%E5%AE%9A" data-line="95" class="code-line">
<a class="header-anchor-link" href="#%E5%BF%9C%E7%94%A8%3A%E5%AE%A3%E8%A8%80%E7%9A%84%E3%81%AA%E8%A8%AD%E5%AE%9A" aria-hidden="true"></a> 応用:宣言的な設定</h1>
先程のhome-manager自体の導入で <code>home-manager</code> コマンドが使えるようになりましたが、これは生成された <code>home.nix</code> 内の <code>programs.home-manager.enable = true;</code> の記述により実現しています。 
この設定は home-managerのリポジトリ内の<a href="https://github.com/nix-community/home-manager/blob/7abcf59a365430b36f84eaa452a466b11e469e33/modules/programs/home-manager.nix" target="_blank" rel="nofollow noopener noreferrer">modules/programs/home-manager.nix</a>に定義されており、最終的に <code>home.packages</code> の宣言に展開されます。 
home-managerではこのようなモジュールが多数定義されており、対応しているプログラムの設定であれば宣言で設定を記述できます。 
何が設定できるかは<a href="https://nix-community.github.io/home-manager/options.xhtml" target="_blank" rel="nofollow noopener noreferrer">マニュアル</a>に一覧がある他、<a href="https://github.com/nix-community/home-manager/tree/master/modules" target="_blank" rel="nofollow noopener noreferrer">リポジトリ</a>を直接参照して確認できます。

home-manager入門

Discussion