Latest revision as of 20:14, 2 September 2024

Introduction

This is an incomplete guide on installing NixOs, using flakes and home-manager.

Be sure to have an ISO image of NixOS, which can be obtained here: https://nixos.org/download/#nixos-iso.

Installation guide

Partitioning your disk

Boot the installation medium.
Open a terminal.
Wipe your disk: $ blkdiscard /dev/<installation disk>.
Create root and boot partitions:

Use parted

$ parted <installation disk>
(parted) mklabel gpt

Boot partition

(parted) mkpart
(parted) Partitoin name? boot
(parted) File system type? fat32
(parted) Start? 0%
(parted) End? 2GB
(parted) set 1 esp on
(parted) set 1 boot on

Root partition

(parted) mkpart
(parted) Partitoin name? root
(parted) File system type? btrfs
(parted) Start? 2GB
(parted) End? 100%
(parted) quit

Configure and mount partitions

$ mkfs.btrfs /dev/<root partition>
$ mkfs.vfat -F32 /dev/<boot partition>
$ mount /dev/<root partition> /mnt
$ mkdir /mnt/boot
$ mount /dev/<boot partition> /mnt/boot

Generate and edit config

$ sudo nixos-generate-config --root /mnt
Edit your configuration: $ nvim /mnt/etc/nixos/configuration.nix
Checkout your hardware config: $ nvim /mnt/etc/nixos/hardware-configuration.nix
Remember to add the following to configuration.nix so that grub works with EFI:

boot.loader.grub.enable = true;
boot.loader.grub.efiSupport = true;
boot.loader.grub.device = "nodev";
boot.loader.efi.canTouchEfiVariables = true;

Note: This is an example of my configuration: https://git.posixlycorrect.com/fabian/desktop_config

Install

$ sudo nixos-install
Set root password when prompted to do so.
Reboot your machine
Login as root and set a password for your user: $ passwd <username>
Logout and login as your user

Enable flakes and replace your config with your flake

Flake

$ mkdir nix
Create your $ vim flake.nix
$ nixos rebuidl switch

Home manager

$ nix repl .

home = homeConfigurations.<configuration name>
home.activationPackage

Copy the resulting path and do:
$ build <path>
./result/activate

@@ Line 2: / Line 2: @@
 = Introduction =
-This is a complete guide on installing NixOs, using flakes.
+This is an incomplete guide on installing NixOs, using flakes and home-manager.
 Be sure to have an ISO image of NixOS, which can be obtained here: https://nixos.org/download/#nixos-iso.
@@ Line 8: / Line 8: @@
 = Installation guide =
 == Partitioning your disk ==
+# Boot the installation medium.
 # Open a terminal.
 # Wipe your disk: {{ic|$ blkdiscard /dev/<installation disk>}}.
@@ Line 45: / Line 46: @@
 == Generate and edit config  ==
 # {{ic|$ sudo nixos-generate-config --root /mnt}}
-# {{ic|$ nvim /mnt/etc/nixos/configuration.nix}}
+# Edit your configuration: {{ic|$ nvim /mnt/etc/nixos/configuration.nix}}
-# {{ic|$ nvim /mnt/etc/nixos/hardware-configuration.nix}}
+# Checkout your hardware config: {{ic|$ nvim /mnt/etc/nixos/hardware-configuration.nix}}
-# Remember to add the following configuration so that grub works with EFI:
+# Remember to add the following to {{ic|configuration.nix}} so that grub works with EFI:
 <pre>
 boot.loader.grub.enable = true;
@@ Line 54: / Line 55: @@
 boot.loader.efi.canTouchEfiVariables = true;
 </pre>
+{{note|This is an example of my configuration: https://git.posixlycorrect.com/fabian/desktop_config}}
 == Install ==
@@ Line 61: / Line 63: @@
 # Login as root and set a password for your user: {{ic|$ passwd <username>}}
 # Logout and login as your user
+= Enable flakes and replace your config with your flake =
+==== Flake ====
+# {{ic|$ mkdir nix}}
+# Create your {{ic|$ vim flake.nix}}
+# {{ic|$ nixos rebuidl switch}}
+==== Home manager ====
+# {{ic|$ nix repl .}}
+<pre>
+home = homeConfigurations.<configuration name>
+home.activationPackage
+</pre>
+# Copy the resulting path and do:
+# {{ic|$ build <path>}}
+# ./result/activate