_
__ _| |__ _____ __
\ \ / / '_ \ / _ \ \/ /
\ V /| |_) | (_) > <
\_/ |_.__/ \___/_/\_\
A streamlined interface for VBoxManage, the VirtualBox command line tool.
vbox
wraps VBoxManage
, providing a simpler UI with a focus on frequently
used commands.
To install with Homebrew:
brew tap xwmx/taps
brew install vbox
To install with npm:
npm install --global vbox.sh
To install with bpkg:
bpkg install xwmx/vbox
To install manually, simply add the vbox
script to your $PATH
. If
you already have a ~/bin
directory, you can use the following command:
curl -L https://raw.github.com/xwmx/vbox/master/vbox \
-o ~/bin/vbox && chmod +x ~/bin/vbox
Usage:
vbox commands [--raw]
vbox config [--path]
vbox forwarding add <vm-name> <rule-name> <port>
vbox forwarding list <vm-name>
vbox forwarding delete <vm-name> <rule-name>
vbox (help [<command>] | -h | --help)
vbox kill (<name> | <uuid>)
vbox list [running | status]
vbox manage [<general option>] <command>
vbox pause (<name> | <uuid>)
vbox reset (<name> | <uuid>)
vbox resume (<name> | <uuid>)
vbox show (<name> | <uuid>)
vbox start (<name> | <uuid>) [--headless]
vbox status [(<name> | <uuid>) [--long|-l]]
vbox stop (<name> | <uuid>)
vbox (version | --version)
Global Options:
-h --help Display this help information.
--version Display version information.
Help:
vbox help [<command>]
Usage:
vbox commands [--raw]
Options:
--raw Display the command list without formatting.
Description:
Display the list of available commands.
Usage:
vbox config [--path]
Options:
--path Print the path to the configuration file, 'VirtualBox.xml'.
Description:
When no argument has been passed, open the 'VirtualBox.xml' configuration
file in `$EDITOR`, which is currently set to ''. When the
`--path` option is specified, the path to 'VirtualBox.xml' is printed.
Usage:
vbox forwarding add <vm-name> <rule-name> <port>
vbox forwarding list <vm-name>
vbox forwarding delete <vm-name> <rule-name>
Subcommands:
add Add a new port forwarding rule.
list List forwarding rules.
delete Delete the specified rule.
Description:
Manage port forwarding.
Example:
vbox forwarding add "ubuntu-vm" "tcp5000" "5000"
Equivalent of:
VBoxManage controlvm ubuntu-vm \
natpf1 "tcp5000,tcp,127.0.0.1,5000,,5000"
Usage:
vbox help [<command>]
Description:
Display help information for vbox or a specified command.
Usage:
vbox kill (<name> | <uuid>)
Description:
Command: `VBoxManage controlvm <vm> poweroff`
Has the same effect on a virtual machine as pulling the power cable on a real
computer. The state of the VM is not saved beforehand, and data may be lost.
(This is equivalent to selecting the "Close" item in the "Machine" menu of
the GUI or pressing the window's close button, and then selecting "Power off
the machine" in the dialog.)
Usage:
vbox list [running | status]
Arguments:
running List all running VMs.
status Display all VMs with basic status information.
Description:
List VirtualBox VMs.
Usage:
vbox manage [<general option>] <command>
Description:
Alias for `VBoxManage`.
VBoxManage Documentation:
https://www.virtualbox.org/manual/ch08.html
Usage:
vbox pause (<name> | <uuid>)
Description:
Command: `VBoxManage controlvm <vm> pause`
Temporarily puts a virtual machine on hold, without changing its state for
good. The VM window will be painted in gray to indicate that the VM is
currently paused. (This is equivalent to selecting the "Pause" item in the
"Machine" menu of the GUI.)
Usage:
vbox reset (<name> | <uuid>)
Description:
Command: `VBoxManage controlvm <vm> reset`
Has the same effect on a virtual machine as pressing the "Reset" button on a
real computer: a cold reboot of the virtual machine, which will restart and
boot the guest operating system again immediately. The state of the VM is not
saved beforehand, and data may be lost. (This is equivalent to selecting the
"Reset" item in the "Machine" menu of the GUI.)
Usage:
vbox resume (<name> | <uuid>)
Description:
Command: `VBoxManage controlvm <vm> resume`
Undo a previous pause command. (This is equivalent to selecting the "Resume"
item in the "Machine" menu of the GUI.)
Usage:
vbox show (<name> | <uuid>)
Description:
Command: `VBoxManage showvminfo <vm>`
Show information about a particular virtual machine.
Usage:
vbox start (<name> | <uuid>) [--headless]
Description:
Start the VM with the given name or UUID.
Usage:
vbox status [(<name> | <uuid>) [--long|-l]]
Options:
-l --long Display long-form status information for the specified VM.
Description:
When no argument has been passed, this acts as an alias for
`vbox list status` and displays the status for all of the VMs. When
passed a VM name or UUID, the status aka state of that VM is displayed.
Usage:
vbox stop (<name> | <uuid>)
Description:
Command: `VBoxManage controlvm <vm> savestate`
Save the current state of the VM to disk and then stop the VM. (This is
equivalent to selecting the "Close" item in the "Machine" menu of the GUI or
pressing the window's close button, and then selecting "Save the machine
state" in the dialog.)
Usage:
vbox (version | --version)
Description:
Display the current program version.