simulation/README: Note for running on NixOS

This commit is contained in:
Fintan Halpenny 2026-04-23 17:16:00 +01:00
parent 277f2615c9
commit f22811e015
1 changed files with 13 additions and 0 deletions

View File

@ -15,6 +15,19 @@ To run the simulation environment, you need the following tools installed on you
- **[cue](https://cuelang.org/)**: (Optional) Useful for debugging and formatting CUE files. - **[cue](https://cuelang.org/)**: (Optional) Useful for debugging and formatting CUE files.
- **[QEMU](https://www.qemu.org/download/)** or **[Docker](https://www.docker.com/)**: Required by Talos to provision the local cluster nodes. (Defaults to `qemu`). - **[QEMU](https://www.qemu.org/download/)** or **[Docker](https://www.docker.com/)**: Required by Talos to provision the local cluster nodes. (Defaults to `qemu`).
### NixOS
On NixOS it is necessary to enable the following in your `configuration.nix`:
```
# Kernel modules for QEMU/talosctl networking
boot.kernelModules = ["kvm-amd" "tun" "bridge" "veth"]; # or kvm-intel
# /dev/kvm access
virtualisation.libvirtd.enable = true; # or just ensure kvm group access
# Allow talos as a trusted firewall interface
networking.firewall.trustedInterfaces = ["talos+"];
```
## Getting Started ## Getting Started
The environment is managed entirely via `just`. From the `simulation` directory, you can run: The environment is managed entirely via `just`. From the `simulation` directory, you can run: