update: README.md install guide

This commit is contained in:
Melvin Ragusa
2026-02-02 11:43:58 +01:00
parent 638b238f7e
commit 90fafac5c9

View File

@@ -20,51 +20,46 @@ Personal NixOS desktop configuration built with **Nix flakes** for x86_64-linux.
## Installation (fresh NixOS install) ## Installation (fresh NixOS install)
1. **Download and boot the NixOS ISO** 1. **Download and boot the NixOS graphical installer**
- <https://nixos.org/download.html> - <https://nixos.org/download.html>
2. **Connect to the network** (for cloning and downloading packages) 2. **Follow the graphical installer**
- Partition your drives as needed
- Create your user account
- When prompted for desktop environment, select **No desktop**
- Complete the installation
3. **Partition and mount disks** 3. **Reboot and log in** to your new shell-only NixOS system
- Follow the NixOS manual for your disk layout: <https://nixos.org/manual/nixos/stable/#sec-installation>
4. **Generate hardware configuration** 4. **Clone this repository**
```sh ```sh
sudo -i git clone https://github.com/ragusa-it/nixos ~/nixos
nixos-generate-config --root /mnt
``` ```
5. **Clone this repository into the target system** 5. **Copy your hardware configuration into the repo**
```sh ```sh
git clone https://github.com/ragusa-it/nixos /mnt/etc/nixos/atlas cp /etc/nixos/hardware-configuration.nix ~/nixos/hardware-configuration.nix
``` ```
6. **Copy the generated hardware config into the repo** 6. **Review and customize**
```sh
cp /mnt/etc/nixos/hardware-configuration.nix /mnt/etc/nixos/atlas/hardware-configuration.nix
```
7. **Review and customize**
- `configuration.nix` - `configuration.nix`
- `networking.hostName` - `networking.hostName`
- `users.users.pinj` (change username/groups as needed) - `users.users.pinj` (change username/groups as needed)
- `modules/gpu-amd.nix` if you are **not** on AMD hardware - `modules/gpu-amd.nix` if you are **not** on AMD hardware
8. **Install NixOS using the flake** 7. **Rebuild with the flake**
```sh ```sh
export NIX_CONFIG="experimental-features = nix-command flakes" sudo nixos-rebuild switch --flake ~/nixos#nixos
nixos-install --flake /mnt/etc/nixos/atlas#nixos
``` ```
9. **Reboot into the new system** 8. **Reboot** to start the full desktop environment
```sh ```sh
reboot sudo reboot
``` ```
## Post-install rebuilds ## Post-install rebuilds
@@ -109,8 +104,8 @@ sudo nixos-rebuild switch --flake .#nixos
## Troubleshooting ## Troubleshooting
- **Flakes not enabled**: ensure the `NIX_CONFIG` environment variable is set (see install step) or enable flakes in `/etc/nix/nix.conf`. - **Flakes not enabled**: if `nixos-rebuild` fails, prefix the command with `NIX_CONFIG="experimental-features = nix-command flakes"` or enable flakes in `/etc/nix/nix.conf`.
- **Wrong hardware configuration**: regenerate with `nixos-generate-config --root /` and replace `hardware-configuration.nix`. - **Wrong hardware configuration**: regenerate with `sudo nixos-generate-config` and copy the new `hardware-configuration.nix` into the repo.
## License ## License