VirtualMachineConfig

apiVersion: v1alpha1
kind: VirtualMachineConfig
name: vm1 # Name of the virtual machine.
powerState: running # Power state the virtual machine is driven towards.
# Processor settings for the virtual machine.
cpu:
    count: 4 # Number of virtual CPUs presented to the guest.
    limit: 3000m # Host CPU ceiling in millicores for the whole virtual machine, vCPUs and emulator threads
    # Optional guest CPU geometry and host CPU pinning.
    topology:
        sockets: 1 # Number of guest sockets. If any geometry dimension is set, all three must be
        cores: 2 # Number of guest cores per socket, not host CPU IDs.
        threads: 2 # Number of guest threads per core, not host CPU IDs.
        # Host CPUs the guest's threads are pinned to; independent of guest geometry and `cpu.limit`.
        pinning:
            # Per-vCPU pins.
            vcpus:
                - vcpu: 0 # Guest vCPU index, starting at 0 and below `cpu.count`.
                  cpus: "8" # Host CPUs the vCPU is pinned to, as a Linux CPU list, e.g. `8` or `9-10`.
                - vcpu: 1 # Guest vCPU index, starting at 0 and below `cpu.count`.
                  cpus: 9-10 # Host CPUs the vCPU is pinned to, as a Linux CPU list, e.g. `8` or `9-10`.
            emulator: 0-1 # Host CPUs the emulator threads (everything of the virtual machine that is not a vCPU)
# Memory settings for the virtual machine.
memory:
    size: 4GiB # Memory allocated to the guest at boot.
    # Memory ballooning settings.
    ballooning:
        enabled: true # Attach a virtio-balloon device, letting the host reclaim memory the guest is not using.
    # Host NUMA nodes the guest memory is placed on.
    numa:
        mode: strict # How guest memory is bound to the nodes.
        nodes: "1" # Host NUMA nodes the guest memory is placed on, as a Linux node list, e.g. `1` or `0-1`.
# Firmware the virtual machine boots.
firmware:
    type: uefi # Firmware the guest boots.
    # Secure boot settings.
    secureBoot:
        enabled: true # Boot the guest with secure boot.
# Disks attached to the virtual machine.
disks:
    - name: system # Name of the disk, unique within the virtual machine.
      pool: pool1 # Name of the `StoragePool` document this disk's volume lives in.
      size: 20GiB # Size of the volume.
      bootOrder: 1 # Position of this disk in the guest's boot order, lowest first.
      # Where the volume's contents come from.
      provision:
        # Create an empty volume, formatted per `format`.
        blank: {}
    - name: data # Name of the disk, unique within the virtual machine.
      pool: pool1 # Name of the `StoragePool` document this disk's volume lives in.
      size: 100GiB # Size of the volume.
      # Where the volume's contents come from.
      provision:
        # Create an empty volume, formatted per `format`.
        blank: {}
    - name: install # Name of the disk, unique within the virtual machine.
      type: cdrom # Kind of device the disk is presented as.
      bootOrder: 2 # Position of this disk in the guest's boot order, lowest first.
      # Where the volume's contents come from.
      provision:
        # Attach read-only CD-ROM media from a content library.
        fromImage:
            library: images # Name of the `ContentLibraryConfig` document holding the image.
            file: ubuntu-24.04.iso # Name of the file within that library.

            # # Integrity check of the library file, verified before the media is attached.
            # digest: sha256:5f2bc19e8b4b5b4a8b5e9c0d1f2a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c

      # # Name of the `StoragePool` document this disk's volume lives in.
      # pool: pool1
# Consoles attached to the virtual machine.
console:
    # Serial console settings.
    serial:
        enabled: true # Attach a serial console.
    # VNC console settings.
    vnc:
        enabled: true # Attach a VNC console.
# Networking settings for the virtual machine.
networking:
    # Network interfaces presented to the guest.
    interfaces:
        - name: net0 # Name of the interface, unique within the virtual machine.
          link: eth0 # Kernel name (or alias) of the host link the interface is attached to.

          # # Hardware (MAC) address presented to the guest.
          # hardwareAddr: 52:54:00:12:34:56
        - name: net1 # Name of the interface, unique within the virtual machine.
          link: eth1 # Kernel name (or alias) of the host link the interface is attached to.

          # # Hardware (MAC) address presented to the guest.
          # hardwareAddr: 52:54:00:12:34:56
# Settings which apply inside the guest.
guest:
    # Seed handed to the guest on first boot.
    cloudInit:
        library: targetlibrary # Name of the content library where Talos stores the generated NoCloud ISO.
        metaData: | # Contents of the seed's `meta-data` file, carrying the guest's identity.
            instance-id: vm1-001
            local-hostname: vm1
        userData: | # Contents of the seed's `user-data` file, carrying what the operator wants done.
            #cloud-config
            users:
              - name: op
                ssh_authorized_keys:
                  - ssh-ed25519 AAAAC3NzaC1lZDI1NTE5...
    # qemu-guest-agent settings.
    agent:
        enabled: true # Attach the qemu-guest-agent virtio-serial channel to the domain.