From b6435c777eeae8548d50662190b0462bfe34bb3b Mon Sep 17 00:00:00 2001 From: Logan Blyth Date: Mon, 13 Jul 2026 17:08:53 -0400 Subject: [PATCH] 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.