The VBoxBugReport command is used to collect debug information automatically for an installation. This command can be useful when you need to gather information to send to Oracle Support.

The following examples show how to use VBoxBugReport.

By default, the command collects VBoxSVC process logs, device settings, and global configuration data for an host.

$ VBoxBugReport
  ...
  0% - collecting VBoxSVC.log.10...
  7% - collecting VBoxSVC.log.9...
  ...
 64% - collecting VBoxSVC.log.1...
 71% - collecting VBoxSVC.log...
 78% - collecting VirtualBox.xml...
 85% - collecting HostUsbDevices...
 92% - collecting HostUsbFilters...
100% - compressing...

Report was written to '2019-03-26-13-32-02-bugreport.tgz'

The results are saved as a compressed tar file archive in the same directory where the command is run.

To specify a different output file location:

$ VBoxBugReport --output ~/debug/bug004.tgz

To output all debug information to a single text file, rather than a tgz file:

$ VBoxBugReport --text

To collect information for a specific VM, called Windows_10:

$ VBoxBugReport Windows_10

This command collects machine settings, guest properties, and log files for the specified VM. Global configuration information for the host is also included.

To collect information for several VMs, called Windows_7, Windows_8, and Windows_10:

$ VBoxBugReport Windows_7 Windows_8 Windows_10

To collect information for all VMs:

$ VBoxBugReport --all

To show a full list of the available command options, run VBoxBugReport --help.