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

VBoxManage setproperty

VBoxManage-setproperty 1
VBoxManage-setproperty change global settings &product-name;
`VBoxManage setproperty` property-name property-value

## Description

The `VBoxManage setproperty` command enables you to change global settings that affect the entire &product-name; installation. Some of these settings correspond to the settings in the Preferences dialog in the VirtualBox Manager.

The following properties are available:

`autostartdbpath`

  Specifies the path to the autostart database. Valid values are `null`, which disables the autostart database, or the name of the folder that contains the database. See .

`defaultfrontend`

  Specifies the global default VM frontend. Valid values are `default`, which specifies the default frontend, or the name of the frontend to use.

`hwvirtexclusive`

  Specifies whether &product-name; makes exclusive use of the Intel VT-x or AMD-V hardware virtualization extensions of the host system's processor.

  Valid values are as follows:

  - `on` enables &product-name; to make exclusive use of these extensions. This is the default value.

  - `off` shares these extensions with other hypervisors that run simultaneously. Note that sharing these extensions has negative performance implications.

`language`

  Specifies the user language used to translate API messages. Valid values are `C`, which means no translation or a language code in the form of either `ll` or `ll_CC`, where `ll` is an ISO 639 two-letter language code and `CC` an ISO 3166 two-letter country code. For example, for Greek in Greece, `ll` is `el`, and `CC` is `GR`.

`logginglevel`

  Specifies the VBoxSVC release logging details. See .

`loghistorycount`

  Specifies the number of rotated VM logs to retain.

`machinefolder`

  Specifies the default folder in which virtual machine (VM) definitions are stored. Valid values are `default`, which specifies the default storage folder, or the name of the folder to use. See .

`proxymode`

  Configures the mode for an HTTP proxy server. Valid values are as follows:

  `manual`

    Configure the URL of a HTTP proxy server manually, using the `proxyurl` property value.

  `noproxy`

    Do not use an HTTP proxy server. A direct connection to the Internet is used.

  `system`

    Detect the proxy settings automatically for the host network. This is the default value.

`proxyurl`

  Specifies the URL for an HTTP proxy server when you specify a manual proxy by setting the `proxymode` property to `manual`.

`vrdeauthlibrary`

  Specifies which library to use when external authentication has been configured for a particular VM. Valid values are `default`, which specifies the default library, or the name of the library to use. See .

`vrdeextpack`

  Specifies the library that implements the VirtualBox Remote Desktop Extension (RDE). Valid values are `null`, which disables the RDE, or the name of the library to use.

`websrvauthlibrary`

  Specifies which library the web service uses to authenticate users. Valid values are `default`, which specifies the default library, `null`, which disables authentication, or the name of the library to use. For information about the &product-name; web service, see .

## Examples

The following command configures &product-name; to use the specified HTTP proxy server.

    $ VBoxManage setproperty proxymode manual
    $ VBoxManage setproperty proxyurl "http://myproxy.com:8080"

## See Also