# A practical kickstart to home manager

**URL:** https://discourse.nixosstag.fcio.net/t/a-practical-kickstart-to-home-manager/40180
**Category:** Guides
**Created:** [February 23, 2024, 7:43am UTC](https://discourse.nixosstag.fcio.net/t/a-practical-kickstart-to-home-manager/40180 "2024-02-23T07:43:29Z")
**Posts on this page:** 7
**Page:** 1

<div class="post-metadata">

### Author: ![evertras](https://discourse.nixosstag.fcio.net/user_avatar/discourse.nixosstag.fcio.net/evertras/32/12184_2.png) [@evertras](https://discourse.nixosstag.fcio.net/u/evertras)
#### Post date: [February 23, 2024, 7:43am UTC](https://discourse.nixosstag.fcio.net/t/a-practical-kickstart-to-home-manager/40180/1 "2024-02-23T07:43:29Z")

</div>

> **[GitHub - Evertras/simple-homemanager: A guide to getting started with home...](https://github.com/evertras/simple-homemanager)**
>
> A guide to getting started with home manager with flakes and all that 2024 goodness. - Evertras/simple-homemanager

When I first tried Nix, I spent a lot of time bouncing off various in-depth tutorials and documentation, but it had taken me a while to actually get started with anything really useful to build on. Some coworkers were interested in getting started with home manager and nix in general and I didn’t actually know where to point them as a single source, so I wrote this to get them started. Will add to it over time if there’s interest.

---

<div class="post-metadata">

### Author: ![talariarik](https://discourse.nixosstag.fcio.net/letter_avatar_proxy/v4/letter/t/d6d6ee/32.png) [@talariarik](https://discourse.nixosstag.fcio.net/u/talariarik)
#### Post date: [February 23, 2024, 11:23am UTC](https://discourse.nixosstag.fcio.net/t/a-practical-kickstart-to-home-manager/40180/2 "2024-02-23T11:23:45Z")

</div>

You make me laughing loud. I enjoy following (mostly reading and share the beginner feeling) your text. And already forked your nixos-configuration …  
Thank you

---

<div class="post-metadata">

### Author: ![brisk.pm](https://discourse.nixosstag.fcio.net/user_avatar/discourse.nixosstag.fcio.net/brisk.pm/32/15684_2.png) [@brisk.pm](https://discourse.nixosstag.fcio.net/u/brisk.pm)
#### Post date: [February 29, 2024, 1:04pm UTC](https://discourse.nixosstag.fcio.net/t/a-practical-kickstart-to-home-manager/40180/3 "2024-02-29T13:04:51Z")

</div>

I very much enjoyed this form of instruction. Thank you! I was able to understand the flake form at a practical level and could dive into the why’s and structure after getting a working template.

I tried to submit two issues to GitHub but the new account got flagged as spam.

## Add cd directive to 02 Init a git repository

The git commands are missing a change directory between the directory creation and git init

```auto
mkdir my-home-manager
cd my-home-manager
git init

```

## The [instructions linked to install home-manager](https://github.com/Evertras/simple-homemanager/blob/df40fdea0657ce7ef9470917ca389afe0fdf1548/01-install.md#install-home-manager) point the user to install home-manager with

`nix-shell '<home-manager>' -A install`

In order to progress I had to add a nixpkgs channel and update the $NIX\_PATH in my environment:

```sh
nix-channel --add https://nixos.org/channels/nixpkgs-unstable nixpkgs
export NIX_PATH=$NIX_PATH:$HOME/.nix-defexpr/channels

```

Also using the nix-shell install method wiped the home-manager path after the [first make command that runs home-manager switch](https://github.com/Evertras/simple-homemanager/blob/df40fdea0657ce7ef9470917ca389afe0fdf1548/02-basic-repository-setup.md#your-first-tinkering).

I was able to get home-manager persistently available with `nix profile install home-manager`. I’m not sure if this my unfamiliarity with nix or if the instructions are unclear for a multi-user nix install on a foreign distro.

---

<div class="post-metadata">

### Author: ![evertras](https://discourse.nixosstag.fcio.net/user_avatar/discourse.nixosstag.fcio.net/evertras/32/12184_2.png) [@evertras](https://discourse.nixosstag.fcio.net/u/evertras)
#### Post date: [March 2, 2024, 2:36am UTC](https://discourse.nixosstag.fcio.net/t/a-practical-kickstart-to-home-manager/40180/4 "2024-03-02T02:36:45Z")

</div>

Glad it was helpful!

Good catch on the missing `cd`, I’ve added it just now.

I’m a little wary of adding more complicated home manager troubleshooting to this guide, because that should really be part of the home manager docs and will depend on the user. For my part, I followed the standalone instructions on an Ubuntu machine and it worked out of the box. I kind of like your version better and may try that the next time I have to install home manager on a non-NixOS system, but there are many different ways to get it installed and I’d rather just defer to the docs.

---

<div class="post-metadata">

### Author: ![dminca](https://discourse.nixosstag.fcio.net/user_avatar/discourse.nixosstag.fcio.net/dminca/32/16100_2.png) [@dminca](https://discourse.nixosstag.fcio.net/u/dminca)
#### Post date: [March 14, 2024, 9:43am UTC](https://discourse.nixosstag.fcio.net/t/a-practical-kickstart-to-home-manager/40180/5 "2024-03-14T09:43:42Z")

</div>

Wow!  
I just started with Nix for 3 days already and I’m still reading through the wiki trying to find a better way to modularise my configuration.

As a matter of fact, I was looking to combine my `home-manager` config within my flake and you just helped me a lot with this repo.

Thanks so much 🙂

---

<div class="post-metadata">

### Author: ![morgs-za](https://discourse.nixosstag.fcio.net/user_avatar/discourse.nixosstag.fcio.net/morgs-za/32/16029_2.png) [@morgs-za](https://discourse.nixosstag.fcio.net/u/morgs-za)
#### Post date: [May 10, 2024, 6:10pm UTC](https://discourse.nixosstag.fcio.net/t/a-practical-kickstart-to-home-manager/40180/6 "2024-05-10T18:10:35Z")

</div>

Just wanted to say thanks, this has been a god sent, I have been using other configs with crazy things I can only figure out some of the time. This guide made me laugh, see the error of my way and love what im seeing, Really thanks a mil.

PS: I believe this will work on NIXOS too

---

<div class="post-metadata">

### Author: ![c6986](https://discourse.nixosstag.fcio.net/user_avatar/discourse.nixosstag.fcio.net/c6986/32/33556_2.png) [@c6986](https://discourse.nixosstag.fcio.net/u/c6986)
#### Post date: [August 1, 2025, 12:41pm UTC](https://discourse.nixosstag.fcio.net/t/a-practical-kickstart-to-home-manager/40180/7 "2025-08-01T12:41:19Z")

</div>

thank you so much for this, I was terryfied about hm
