docs: Add session start protocol and improve README structure

This commit is contained in:
Julian Sutter 2026-02-16 21:30:50 -08:00
parent af88e29283
commit 9777e88032

View file

@ -1,3 +1,11 @@
# NixOS Configuration Repository
## Session Start Protocol
Always begin by reading agents.md for workflow instructions.
## System Installation
1. Partition the disk:
``` ```
sudo parted /dev/nvme0n1 -- mklabel gpt sudo parted /dev/nvme0n1 -- mklabel gpt
sudo parted /dev/nvme0n1 -- mkpart primary ext4 512MB 100% sudo parted /dev/nvme0n1 -- mkpart primary ext4 512MB 100%
@ -5,7 +13,10 @@ sudo parted /dev/nvme0n1 -- mkpart ESP fat32 1MB 512MB
sudo parted /dev/nvme0n1 -- set 2 esp on sudo parted /dev/nvme0n1 -- set 2 esp on
sleep 2 sleep 2
sudo mkfs.ext4 /dev/disk/by-partlabel/primary sudo mkfs.ext4 /dev/disk/by-partlabel/primary
```
2. Mount the filesystems:
```
sudo mount -o rw /dev/disk/by-partlabel/primary /mnt/ sudo mount -o rw /dev/disk/by-partlabel/primary /mnt/
sudo mkdir /mnt/boot sudo mkdir /mnt/boot
sudo mkfs.vfat /dev/disk/by-partlabel/ESP sudo mkfs.vfat /dev/disk/by-partlabel/ESP
@ -14,13 +25,14 @@ sudo mkdir /mnt/root
sudo git clone https://jsutter:b9cf9383b20dc6efe4d0a732d659709097879b67@git.symbiotrip.com/jsutter/nixos /mnt/root/nixos sudo git clone https://jsutter:b9cf9383b20dc6efe4d0a732d659709097879b67@git.symbiotrip.com/jsutter/nixos /mnt/root/nixos
``` ```
Then: 3. Install NixOS:
``` ```
sudo -i sudo -i
cd /mnt/root/nixos cd /mnt/root/nixos
nixos-install --flake .#<name> --no-root-password --impure nixos-install --flake .#<name> --no-root-password --impure
``` ```
Finally:
4. Set user password:
``` ```
nixos-enter --root '/mnt' nixos-enter --root '/mnt'
passwd jsutter passwd jsutter