$Date: 2025-08-11 19:18:47 +0200 (Mon, 11 Aug 2025) $

VBoxManage registervm

VBoxManage-registervm 1
VBoxManage-registervm register a virtual machine &product-name;
`VBoxManage registervm` filename --password file

## Description

The `VBoxManage registervm` command enables you to create a virtual machine (VM) by importing an XML machine configuration file into &product-name;. The VM cannot have the same UUID as a VM that is already registered in &product-name;. Ensure that the XML machine configuration file is in the machines folder prior to registration.

When you use the `VBoxManage createvm` command to create a VM, you can specify the `--register` option to register the VM.

filename

  Specifies the XML machine configuration file. This file has the `.vbox` file extension.

`--password`

  Use the `--password` to supply the encryption password of the VM. Either specify the absolute pathname of a password file on the host operating system, or `-` to prompt you for the password on the command line.

## Examples

The following command registers a VM called `vm2`. The XML machine configuration file for the VM is located in the default machines folder.

    $ VBoxManage registervm "/home/user/VirtualBox VMs/vm2/vm2.vbox"

## See Also

,