From 7689f6599943aefc9e5ae1b0d0d0fcb69c8c4ed7 Mon Sep 17 00:00:00 2001 From: Logan Blyth Date: Mon, 13 Jul 2026 17:08:53 -0400 Subject: [PATCH 1/2] fix: add small guide for ctrlr as VM Signed-off-by: Logan Blyth --- docs/install-upgrade/install.md | 26 +++++++++++++++++++++++++- 1 file changed, 25 insertions(+), 1 deletion(-) diff --git a/docs/install-upgrade/install.md b/docs/install-upgrade/install.md index 7f0bcd0f9..bb877af5e 100644 --- a/docs/install-upgrade/install.md +++ b/docs/install-upgrade/install.md @@ -86,7 +86,10 @@ There are utilities that assist this process such as [etcher](https://etcher.bal ## Install Control Node -This control node should be given a static IP address. Either a lease or statically assigned. +This control node should be given a static IP address. Either a lease or +statically assigned. Running the control node as a virtual machine isn't +officially supported but there are recommendations [in this +section](#controller-as-virtual-machine). 1. Configure the server to use UEFI boot **without** secure boot @@ -121,6 +124,27 @@ interface. It runs a DHCP server, as well as a small HTTP server. The `external` network allows the user to access the control node via their local IT network. It provides SSH access to the host operating system on the control node. +### Controller as Virtual Machine + +These instructions are provided for `libvirt`, adapt as needed for the chosen +hypervisor: + +- Ensure the hardware specs match [the control node](./requirements.md#control-node) +- Disable secure boot: +```xml + + + + + +``` +- Configure the `efi` firmware and `q35` machine type +- Configure the virtual machine for auto start when the host system boots up. +- Configure both NICs as `virtio` +- Ensure a console device is present +- Use VirtIO devices wherever possible + + ### Fabric Manages Switches Now that the install has finished, you can start interacting with the Fabric using `kubectl`, `kubectl fabric` and `k9s`, all pre-installed as part of the Control Node installer. From a48833a3707f52722e637fba30444a88f1bd426f Mon Sep 17 00:00:00 2001 From: Logan Blyth Date: Tue, 21 Jul 2026 10:30:21 -0400 Subject: [PATCH 2/2] feat(guest agent): link to flatcar docs on guest agent Signed-off-by: Logan Blyth --- docs/install-upgrade/install.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/install-upgrade/install.md b/docs/install-upgrade/install.md index bb877af5e..0e2a74ca7 100644 --- a/docs/install-upgrade/install.md +++ b/docs/install-upgrade/install.md @@ -143,6 +143,9 @@ hypervisor: - Configure both NICs as `virtio` - Ensure a console device is present - Use VirtIO devices wherever possible +- The qemu guest agent is built into the flatcar image, create a virtio-port + with the name `org.qemu.guest_agent.0`. More information is on the [flatcar +website](https://www.flatcar.org/docs/latest/os-config/network/acpi/?highlight=guest#qemu-guest-agent) ### Fabric Manages Switches