ItsDrike/nixdots
1
0
Fork 0
mirror of https://github.com/ItsDrike/nixdots synced 2024-09-19 23:29:41 +00:00
Code Issues Packages Projects Releases Wiki Activity

Manage the flake in ~/dots dir

Browse source
This commit is contained in:
ItsDrike 2024-02-21 22:07:08 +01:00
parent 3f1e0f8568
commit 6002b263d7
Signed by: ItsDrike
GPG key ID: FA2745890B7048C0
1 changed files with 25 additions and 18 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

43
guides/installation.md
View file

@ -15,21 +15,10 @@ During this installation, make sure you allow non-free programs, and in the desk
## Set up configuration.nix ## Set up configuration.nix
First thing you'll need to do is to make your useer account own the
`/etc/nixos` directory. You'll want to do this to allow you to easily manage
your config with git (which is a requirement when using flakes). You can use
system wide git, however it is much more convenient to just leave it to the
user, as you'll have your git configuration there.
```sh
cd /etc/nixos
sudo chmod -R itsdrike:users .
```
Out of the box, NixOS only comes with `nano` editor, so we'll have to use that to edit the `configuration.nix` for the first time. Out of the box, NixOS only comes with `nano` editor, so we'll have to use that to edit the `configuration.nix` for the first time.
```sh ```sh
nano configuration.nix sudo nano configuration.nix
``` ```
In there, change the `environment.systemPackages = with pkgs; [];` like, and include `git` and `vim`. In there, change the `environment.systemPackages = with pkgs; [];` like, and include `git` and `vim`.
@ -49,13 +38,25 @@ sudo nixos-rebuild switch
## Set up flakes ## Set up flakes
Now, since a git repository is required for flakes, let's set up git: An interesting things about nix flakes, is that they need to live in a git
repository, you won't be able to rebuild otherwise, so let's set up some git
settings, so that we can make commits:
```sh ```sh
git config --global user.email "itsdrike@protonmail.com" git config --global user.email "itsdrike@protonmail.com"
git config --global user.name "ItsDrike" git config --global user.name "ItsDrike"
``` ```
We could create and manage this repository directly in `/etc/nixos`, however
that's not practical, since we probably want to use our git config and
generally just work in a non-root environment when editing the flake. I like
using the `~/dots` directory.
```sh
cp -r /etc/nixos ~/dots
cd ~/dots
```
Now we have 2 options, the first one I'll show will set up my configuration Now we have 2 options, the first one I'll show will set up my configuration
from this repository. Once done, you will have your system set up in the same from this repository. Once done, you will have your system set up in the same
way that I do. In the second option, I will go over a basic setup to create way that I do. In the second option, I will go over a basic setup to create
@ -71,6 +72,7 @@ git init
git remote add origin https://github.com/ItsDrike/nixdots git remote add origin https://github.com/ItsDrike/nixdots
git branch -M main git branch -M main
git pull origin main git pull origin main
nixos-rebuild switch --flake .
``` ```
## Create your own custom flake ## Create your own custom flake
@ -81,7 +83,7 @@ Initialize an empty git repository:
git init git init
``` ```
Create a very basic `/etc/nixos/flake.nix`: Create a very basic `./flake.nix`:
```sh ```sh
{ {
@ -115,12 +117,17 @@ git add configuration.nix
git add hardware-configuration.nix git add hardware-configuration.nix
``` ```
Now you can run `sudo nixos-rebuild switch`. Yay, you're now using NixOS in flakes mode! Now you can rebuild the system to use our flake:
```sh
sudo nixos-rebuild switch --flake .
```
Yay, you're now using NixOS in flakes mode!
> [!NOTE] > [!NOTE]
> If you run the `sudo nixos-rebuild switch` command before adding all of these > If you run the `sudo nixos-rebuild switch` command, without the `--flake .`
> files to git, you will get an error, so it really is a requirement to have > it would look for the `flake.nix` file in `/etc/nixos`.
> your configuration in a git repository when you're using flakes.
You can notice that this also created a `flake.lock` file, containing the exact You can notice that this also created a `flake.lock` file, containing the exact
versions of all of the packages you're using. Let's add this file to git too: versions of all of the packages you're using. Let's add this file to git too: