FRG: Virtual Machines

Descriptions of each field in the Virtual Machines section of the TrueNAS web interface.

  3 minute read

Virtual Machines: Add

Operating System

Guest Operating SystemChoose the VM operating system type.
NameEnter an alphanumeric name for the virtual machine.
DescriptionDescription (optional).
System Clock *VM system time. Default is Local.
Boot MethodSelect UEFI for newer operating systems or UEFI-CSM (Compatibility Support Mode) for older operating systems that only support BIOS booting. Grub is not recommended but can be used when the other options do not work.
Shutdown TimeoutThe time in seconds the system waits for the VM to cleanly shut down. During system shutdown, the system initiates poweroff for the VM after the shutdown timeout has expired.
Start on BootSet to start this VM when the system boots.
Enable VNCEnable a VNC (Virtual Network Computing) remote connection. Requires UEFI booting.
Delay VM Boot Until VNC ConnectsWait to start VM until VNC client connects.
BindVNC network interface IP address. The primary interface IP address is the default. A different interface IP address can be chosen.

CPU and Memory

Virtual CPUsNumber of virtual CPUs to allocate to the virtual machine. The maximum is 16, or fewer if the host CPU limits the maximum. The VM operating system might also have operational or licensing restrictions on the number of CPUs.
CoresSpecify the number of cores per virtual CPU socket. The product of vCPUs, cores, and threads must not exceed 16.
ThreadsSpecify the number of threads per core. The product of vCPUs, cores, and threads must not exceed 16.
Memory SizeAllocate RAM for the VM. Minimum value is 256 MiB. This field accepts human-readable input (Ex. 50 GiB, 500M, 2 TB). If units are not specified, the value defaults to bytes.


Create new disk imageSelect Create new disk image to create a new zvol on an existing dataset. This is used as a virtual hard drive for the VM. Select Use existing disk image to use an existing zvol or file for the VM.
Select Disk TypeSelect desired disk type.
Zvol LocationSelect a dataset for the new zvol.
SizeAllocate space for the new zvol. (Examples: 500 KiB, 500M, 2 TB) MiB. Units smaller than MiB are not allowed.

Network Interface

Adapter TypeIntel e82545 (e1000) emulates the same Intel Ethernet card. This provides compatibility with most operating systems. VirtIO provides better performance when the operating system installed in the VM supports VirtIO paravirtualized network drivers.
Mac AddressEnter the desired address into the field to override the randomized MAC address.
Attach NICSelect the physical interface to associate with the VM.

Installation Media

Choose Installation Media ImageBrowse to the operating system installer image file.
Upload an Installer Image FileSet to display image upload options.