Register/Unregister a Virtual Machine

Registering a Virtual Machine

prlctl register <path>

Registers a virtual machine in Parallels Desktop. The <path> parameter specifies a path to the virtual machine file.

Optional Parameters

--uuid <UUID>

If included, the specified UUID will be assigned to the virtual machine. A UUID can be generated using console utilities like uuidgen(1)in macOS. If this option is not included, the original UUID will be used.


If included, the virtual machine source ID will be automatically generated (the SMBIOS product ID will be changed as well).


If included, all validation checks will be skipped.

Unregister a Virtual Machine

prlctl unregister <vm_id | vm_name>

Unregisters the specified virtual machine.

Notes: Use the register command when you have a virtual machine on the host that doesn't show up in the list of the virtual machines registered with Parallels Desktop. This can be a machine that was previously removed from Parallels Desktop or a machine that was manually copied from another location.

Once a VM is registered, all VM restrictions on the filesystem are removed. If you would like to protect the VM from editing, you should restrict registering or removing the VM in Parallels Desktop preferences.

The unregister command removes a virtual machine from Parallels Desktop but does not delete it from the host. You can re-register such a machine with Parallels Desktop later using the register command.

Last updated