From f22811e0159b1ff25df40221a4d2595927543f89 Mon Sep 17 00:00:00 2001 From: Fintan Halpenny Date: Thu, 23 Apr 2026 17:16:00 +0100 Subject: [PATCH] simulation/README: Note for running on NixOS --- simulation/README.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/simulation/README.md b/simulation/README.md index ed4c3406..ccb75c59 100644 --- a/simulation/README.md +++ b/simulation/README.md @@ -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. - **[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 The environment is managed entirely via `just`. From the `simulation` directory, you can run: