| 1 | <?xml version='1.0' encoding='UTF-8'?>
|
|---|
| 2 | <!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
|
|---|
| 3 | <topic xml:lang="en-us" id="vboxconfigdata-global">
|
|---|
| 4 | <title>Global Settings</title>
|
|---|
| 5 |
|
|---|
| 6 | <body>
|
|---|
| 7 | <p>
|
|---|
| 8 | In addition to the files for the virtual machines,
|
|---|
| 9 | <ph conkeyref="vbox-conkeyref-phrases/product-name"/> maintains global configuration data in the
|
|---|
| 10 | following directory:
|
|---|
| 11 | </p>
|
|---|
| 12 | <ul>
|
|---|
| 13 | <li>
|
|---|
| 14 | <p><b outputclass="bold">Linux and Oracle Solaris:</b><filepath>$HOME/.config/VirtualBox</filepath>.
|
|---|
| 15 | </p>
|
|---|
| 16 | </li>
|
|---|
| 17 | <li>
|
|---|
| 18 | <p><b outputclass="bold">Windows:</b><filepath>$HOME/.VirtualBox</filepath>.
|
|---|
| 19 | </p>
|
|---|
| 20 | </li>
|
|---|
| 21 | <li>
|
|---|
| 22 | <p><b outputclass="bold">macOS:</b><filepath>$HOME/Library/VirtualBox</filepath>.
|
|---|
| 23 | </p>
|
|---|
| 24 | </li>
|
|---|
| 25 | </ul>
|
|---|
| 26 | <p>
|
|---|
| 27 | <ph conkeyref="vbox-conkeyref-phrases/product-name"/> creates this configuration directory
|
|---|
| 28 | automatically, if necessary. You can specify an alternate
|
|---|
| 29 | configuration directory by either setting the
|
|---|
| 30 | <codeph>VBOX_USER_HOME</codeph> environment variable, or on
|
|---|
| 31 | Linux or Oracle Solaris by using the standard
|
|---|
| 32 | <codeph>XDG_CONFIG_HOME</codeph> variable. Since the global
|
|---|
| 33 | <filepath>VirtualBox.xml</filepath> settings file points to all
|
|---|
| 34 | other configuration files, this enables switching between
|
|---|
| 35 | several <ph conkeyref="vbox-conkeyref-phrases/product-name"/> configurations.
|
|---|
| 36 | </p>
|
|---|
| 37 | <p>
|
|---|
| 38 | In this configuration directory, <ph conkeyref="vbox-conkeyref-phrases/product-name"/> stores its
|
|---|
| 39 | global settings file, an XML file called
|
|---|
| 40 | <filepath>VirtualBox.xml</filepath>. This file includes global
|
|---|
| 41 | configuration options and a list of registered virtual machines
|
|---|
| 42 | with pointers to their XML settings files.
|
|---|
| 43 | </p>
|
|---|
| 44 | </body>
|
|---|
| 45 |
|
|---|
| 46 | </topic>
|
|---|
