%all.entities; ]> August 2019 VBoxManage createvm VBoxManage-createvm 1 VBoxManage-createvm create a new virtual machine Oracle VM VirtualBox VBoxManage createvm --name=name --basefolder=basefolder --default --group=group-ID, ... --ostype=ostype --register --uuid=uuid Description The VBoxManage createvm command creates a new XML virtual machine (VM) definition file. You must specify the name of the VM by using . This name is used by default as the name of the settings file that has the .vbox extension and the machine folder, which is a subfolder of the $HOME/VirtualBox VMs directory. Ensure that the VM name conforms to the host OS file name requirements. If you later rename the VM, the file and folder names will be updated to match the new name automatically. Command Options In addition to specifying the name or UUID of the VM, which is required, you can specify any of the following options: Specifies the name of the folder in which to save the machine configuration file for the new VM. Note that the names of the file and the folder do not change if you rename the VM. Applies a default hardware configuration for the specified guest OS. By default, the VM is created with minimal hardware. Assigns the VM to the specified groups. If you specify more than one group, separate each group name with a comma. Note that each group is identified by a group ID that starts with a slash character (/) so that groups can be nested. By default, a VM is always assigned membership to the / group. Specifies the guest OS to run in the VM. Run the VBoxManage list ostypes command to see the available OS types. Registers the VM with your &product-name; installation. By default, the VBoxManage createvm command creates only the XML configuration for the VM but does not register the VM. If you do not register the VM at creation, you can run the VBoxManage registervm command after you create the VM. Specifies the Universally Unique Identifier (UUID) of the VM. Ensure that this UUID is unique within the &product-name; namespace of the host or of its VM group memberships if you decide to register the VM. By default, &product-name; command provides the UUID. Examples The following command creates a VM called vm2 where you plan to run a 64-bit version of Oracle Linux. $ VBoxManage createvm --name "vm2" --ostype "Oracle_64" The following command creates and registers a VM called vm3. $ VBoxManage createvm --name "vm3" --register See Also ,