Documentation for NixOS configurations

Changes

1 changed files (+27/-0)

• README.md
  • @@ -79,6 +79,33 @@ It removes all generations but the latest one, so Nix's garbage collection can r
    hm-clean ``` + ## NixOS configurations + + Every file under `modules/nixos` is NixOS module. + + A configuration imports a profile module inside `modules/nixos/profiles`, which imports other modules. + A root of an import graph should be a profile module. + + ### Create a NixOS Incus system container + + To create an Incus system container image, run the following command: + + ```sh + nix run .#incus-import workerbee + ``` + + this will generate and import `pocka/workerbee/nixos` image. + + ### Launch VM + + Run the following to launch NixOS VM using QEMU. + + ```sh + nix run .#nixosConfigurations.queenbee.config.system.build.vm -- -device virtio-vga-gl -display gtk,gl=on -enable-kvm -cpu host -m $MEMORY_SIZE + ``` + + You can see a list of options using `--help` option. + ## License This project is compliant with [REUSE specification](https://reuse.software/).