update: README.md install guide
This commit is contained in:
41
README.md
41
README.md
@@ -20,51 +20,46 @@ Personal NixOS desktop configuration built with **Nix flakes** for x86_64-linux.
|
||||
|
||||
## Installation (fresh NixOS install)
|
||||
|
||||
1. **Download and boot the NixOS ISO**
|
||||
1. **Download and boot the NixOS graphical installer**
|
||||
- <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**
|
||||
- Follow the NixOS manual for your disk layout: <https://nixos.org/manual/nixos/stable/#sec-installation>
|
||||
3. **Reboot and log in** to your new shell-only NixOS system
|
||||
|
||||
4. **Generate hardware configuration**
|
||||
4. **Clone this repository**
|
||||
|
||||
```sh
|
||||
sudo -i
|
||||
nixos-generate-config --root /mnt
|
||||
git clone https://github.com/ragusa-it/nixos ~/nixos
|
||||
```
|
||||
|
||||
5. **Clone this repository into the target system**
|
||||
5. **Copy your hardware configuration into the repo**
|
||||
|
||||
```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**
|
||||
|
||||
```sh
|
||||
cp /mnt/etc/nixos/hardware-configuration.nix /mnt/etc/nixos/atlas/hardware-configuration.nix
|
||||
```
|
||||
|
||||
7. **Review and customize**
|
||||
6. **Review and customize**
|
||||
|
||||
- `configuration.nix`
|
||||
- `networking.hostName`
|
||||
- `users.users.pinj` (change username/groups as needed)
|
||||
- `modules/gpu-amd.nix` if you are **not** on AMD hardware
|
||||
|
||||
8. **Install NixOS using the flake**
|
||||
7. **Rebuild with the flake**
|
||||
|
||||
```sh
|
||||
export NIX_CONFIG="experimental-features = nix-command flakes"
|
||||
nixos-install --flake /mnt/etc/nixos/atlas#nixos
|
||||
sudo nixos-rebuild switch --flake ~/nixos#nixos
|
||||
```
|
||||
|
||||
9. **Reboot into the new system**
|
||||
8. **Reboot** to start the full desktop environment
|
||||
|
||||
```sh
|
||||
reboot
|
||||
sudo reboot
|
||||
```
|
||||
|
||||
## Post-install rebuilds
|
||||
@@ -109,8 +104,8 @@ sudo nixos-rebuild switch --flake .#nixos
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
- **Flakes not enabled**: ensure the `NIX_CONFIG` environment variable is set (see install step) or enable flakes in `/etc/nix/nix.conf`.
|
||||
- **Wrong hardware configuration**: regenerate with `nixos-generate-config --root /` and replace `hardware-configuration.nix`.
|
||||
- **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 `sudo nixos-generate-config` and copy the new `hardware-configuration.nix` into the repo.
|
||||
|
||||
## License
|
||||
|
||||
|
||||
Reference in New Issue
Block a user