nixos-demo/README.md

# nixos-demo

## NixOS Installation

### boot the installation image

- download the [minimal iso image](https://nixos.org/download)
- use dd to prepare an USB stick
- boot from the stick

### SSH connection

- use `passwd` to set a temporary password for the `nixos` user
- connect to the PC with `ssh nixos@nixos`
- the official [NixOS installation manual](https://nixos.org/manual/nixos/stable/#sec-installation-manual) describes how to do an installation without the graphical installer

### NixOS installation

- install `git` in a nix-shell for the installation process
- start `nix run` with the related hostname to configure the disks and filesystems
- start the NixOS installation process

```shell
nix-shell -p git
sudo nix --experimental-features "nix-command flakes" run 'github:nix-community/disko?tag=v1.12.0#disko' -- --mode disko --flake 'git+https://code.beancloud.de/public/nixos-demo.git?ref=main#pc-demo1'
sudo nixos-install --no-root-password --flake git+https://code.beancloud.de/public/nixos-demo.git?ref=main#pc-demo1
```

## References

- [nixos.org](https://nixos.org/)
- [NixOS packages](https://search.nixos.org/packages)
- [NixOS config options](https://search.nixos.org/options?)
- [home-manager options](https://nix-community.github.io/home-manager/options.xhtml)
- [Nix explained from the ground up](https://www.youtube.com/watch?v=5D3nUU1OVx8)
- [Zero to Nix Quick start](https://zero-to-nix.com/start/)
- [The Purely Functional Software Deployment Model](https://edolstra.github.io/pubs/phd-thesis.pdf) thesis from Eelco Dolstra