{"id":23247141,"url":"https://github.com/evertras/simple-homemanager","last_synced_at":"2025-04-06T16:14:12.665Z","repository":{"id":221147678,"uuid":"753567435","full_name":"Evertras/simple-homemanager","owner":"Evertras","description":"A practical guide to getting started with home manager with flakes and all that 2024 goodness.","archived":false,"fork":false,"pushed_at":"2024-09-19T12:24:24.000Z","size":168,"stargazers_count":283,"open_issues_count":6,"forks_count":16,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-03-30T15:11:09.807Z","etag":null,"topics":["flakes","home-manager","nix"],"latest_commit_sha":null,"homepage":"","language":"Nix","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Evertras.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-02-06T11:32:17.000Z","updated_at":"2025-03-28T19:11:27.000Z","dependencies_parsed_at":"2024-02-06T14:00:08.203Z","dependency_job_id":"588367a4-83e2-4a67-9c22-a1a81db1abbd","html_url":"https://github.com/Evertras/simple-homemanager","commit_stats":null,"previous_names":["evertras/simple-homemanager"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Evertras%2Fsimple-homemanager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Evertras%2Fsimple-homemanager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Evertras%2Fsimple-homemanager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Evertras%2Fsimple-homemanager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Evertras","download_url":"https://codeload.github.com/Evertras/simple-homemanager/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247509237,"owners_count":20950232,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["flakes","home-manager","nix"],"created_at":"2024-12-19T07:17:33.652Z","updated_at":"2025-04-06T16:14:12.644Z","avatar_url":"https://github.com/Evertras.png","language":"Nix","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Simple start with Nix Home Manager with Flakes\n\n**Do not click around. Read this guide in order. Do all the steps. You'll thank\nme later. See bottom of this readme for the starting link.**\n\nWant to control your entire Linux user space in a declarative, highly\nconfigurable, highly reproducible manner that you can take with you from machine\nto machine without ever worrying about how to rebuild it? Did you try to do that\nwith Nix's Home Manager and hated your life? Read on.\n\n## What is this?\n\nI like Nix. A lot. I think you will too. But I hated getting started with it.\n\nThe documentation for Nix is a headache to wade through and understand in one\ngo. Piecing together random blog posts diving into all the flashy fun cool stuff\nis painful, and many of them are old/stale. Simple, practical starter guides for\nusing [home manager](https://github.com/nix-community/home-manager) were\nsurprisingly difficult to find. Maybe I was just missing them.\n\nRegardless, **this is the guide I wish I had when I started**. All I wanted was\na foundation to start playing with and build on. So here you go: a low-nonsense\nguide to getting started with Home Manager with Flakes.\n\n## Start the journey\n\n### Assumptions\n\nI assume you are running Linux of some sort. This may work on Mac too, but I\nhaven't tried it.\n\nI assume you are NOT running NixOS. If you are, you may want to read a little\nmore carefully when it comes to installing Home Manager. The easiest way to\ninstall it at that point IMO is just adding it as a package to your NixOS\ninstall. After Home Manager is installed, it should all be the same anyway.\n\nI do not assume you have any experience with Nix.\n\nI assume you have some minimal programming knowledge. If you know what a\n\"string\" and a \"function\" are, you're probably fine.\n\n### Please read this bit\n\nThis is not intended to replace the [official documentation of Nix itself](https://nix.dev/),\n[Home Manager](https://nix-community.github.io/home-manager/),\n[nixpkgs](https://nixos.org/manual/nixpkgs/stable/), etc. This is meant to be\nan entry point to get a foundation, so that you can understand what you're\nlooking at in the future.\n\nI am not going to give you deep explanations of why certain things are the way\nthey are. I am not going to give you fifty different ways to do something. The\nrabbit holes of Nix go deep. **Do not stray from the path** until you have\nsomething minimal working, and then I'll show you how to start tinkering. Once\nyou have some minimal tinkering under your belt, everything else in Nix will\nmake so much more sense and you can explore all you want!\n\nIf you see code, don't copy/paste it. Type it yourself. _Neuroscience_. You'll\nlearn it a lot quicker that way.\n\n### Let's go!\n\nOk, ready? **[Let's go! (01-install.md)](01-install.md)**.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevertras%2Fsimple-homemanager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fevertras%2Fsimple-homemanager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevertras%2Fsimple-homemanager/lists"}