| 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="mountingadditionsiso">
|
|---|
| 4 | <title>Installing the Windows Guest Additions</title>
|
|---|
| 5 |
|
|---|
| 6 | <body>
|
|---|
| 7 | <p>
|
|---|
| 8 | In the <b outputclass="bold">Devices</b> menu in the
|
|---|
| 9 | virtual machine's menu bar, <ph conkeyref="vbox-conkeyref-phrases/product-name"/> has a menu item
|
|---|
| 10 | <b outputclass="bold">Insert Guest Additions CD
|
|---|
| 11 | Image</b>, which mounts the Guest Additions ISO file
|
|---|
| 12 | inside your virtual machine. A Windows guest should then
|
|---|
| 13 | automatically start the Guest Additions installer, which
|
|---|
| 14 | installs the Guest Additions on your Windows guest.
|
|---|
| 15 | </p>
|
|---|
| 16 | <p>
|
|---|
| 17 | For other guest operating systems, or if automatic start of
|
|---|
| 18 | software on a CD is disabled, you need to do a manual start of
|
|---|
| 19 | the installer.
|
|---|
| 20 | </p>
|
|---|
| 21 | <note>
|
|---|
| 22 | <p>
|
|---|
| 23 | For the basic Direct3D acceleration to work in a Windows
|
|---|
| 24 | guest, you have to install the WDDM video driver available
|
|---|
| 25 | for Windows Vista or later.
|
|---|
| 26 | </p>
|
|---|
| 27 | <p>
|
|---|
| 28 | For Windows 8 and later, only the WDDM Direct3D video driver
|
|---|
| 29 | is available. For basic Direct3D acceleration to work in
|
|---|
| 30 | Windows XP guests, you have to install the Guest Additions
|
|---|
| 31 | in Safe Mode. See <xref href="KnownIssues.dita">Known Limitations</xref> for
|
|---|
| 32 | details.
|
|---|
| 33 | </p>
|
|---|
| 34 | </note>
|
|---|
| 35 | <p>
|
|---|
| 36 | If you prefer to mount the Guest Additions manually, you can
|
|---|
| 37 | perform the following steps:
|
|---|
| 38 | </p>
|
|---|
| 39 | <ol>
|
|---|
| 40 | <li>
|
|---|
| 41 | <p>
|
|---|
| 42 | Start the virtual machine in which you have installed
|
|---|
| 43 | Windows.
|
|---|
| 44 | </p>
|
|---|
| 45 | </li>
|
|---|
| 46 | <li>
|
|---|
| 47 | <p>
|
|---|
| 48 | Select <b outputclass="bold">Optical Drives</b>
|
|---|
| 49 | from the <b outputclass="bold">Devices</b> menu in
|
|---|
| 50 | the virtual machine's menu bar and then
|
|---|
| 51 | <b outputclass="bold">Choose/Create a Disk
|
|---|
| 52 | Image</b>. This displays the Virtual Media Manager,
|
|---|
| 53 | described in <xref href="virtual-media-manager.dita#virtual-media-manager"/>.
|
|---|
| 54 | </p>
|
|---|
| 55 | </li>
|
|---|
| 56 | <li>
|
|---|
| 57 | <p>
|
|---|
| 58 | In the Virtual Media Manager, click
|
|---|
| 59 | <b outputclass="bold">Add</b> and browse your host
|
|---|
| 60 | file system for the
|
|---|
| 61 | <filepath>VBoxGuestAdditions.iso</filepath> file.
|
|---|
| 62 | </p>
|
|---|
| 63 | <ul>
|
|---|
| 64 | <li>
|
|---|
| 65 | <p>
|
|---|
| 66 | On a Windows host, this file is in the <ph conkeyref="vbox-conkeyref-phrases/product-name"/>
|
|---|
| 67 | installation directory, usually in
|
|---|
| 68 | <filepath>C:\Program
|
|---|
| 69 | files\Oracle\VirtualBox</filepath>.
|
|---|
| 70 | </p>
|
|---|
| 71 | </li>
|
|---|
| 72 | <li>
|
|---|
| 73 | <p> On macOS hosts, this file is in the application bundle of <ph
|
|---|
| 74 | conkeyref="vbox-conkeyref-phrases/product-name"/>. Right-click the <ph
|
|---|
| 75 | conkeyref="vbox-conkeyref-phrases/product-name"/> icon in Finder and choose <b
|
|---|
| 76 | outputclass="bold">Show Package Contents</b>. The file is located in the
|
|---|
| 77 | <filepath>Contents/MacOS</filepath> folder. </p>
|
|---|
| 78 | </li>
|
|---|
| 79 | <li>
|
|---|
| 80 | <p>
|
|---|
| 81 | On a Linux host, this file is in the
|
|---|
| 82 | <filepath>additions</filepath> folder where you
|
|---|
| 83 | installed <ph conkeyref="vbox-conkeyref-phrases/product-name"/>, usually
|
|---|
| 84 | <filepath>/opt/VirtualBox/</filepath>.
|
|---|
| 85 | </p>
|
|---|
| 86 | </li>
|
|---|
| 87 | <li>
|
|---|
| 88 | <p>
|
|---|
| 89 | On Oracle Solaris hosts, this file is in the
|
|---|
| 90 | <filepath>additions</filepath> folder where you
|
|---|
| 91 | installed <ph conkeyref="vbox-conkeyref-phrases/product-name"/>, usually
|
|---|
| 92 | <filepath>/opt/VirtualBox</filepath>.
|
|---|
| 93 | </p>
|
|---|
| 94 | </li>
|
|---|
| 95 | </ul>
|
|---|
| 96 | </li>
|
|---|
| 97 | <li>
|
|---|
| 98 | <p>
|
|---|
| 99 | In the Virtual Media Manager, select the ISO file and
|
|---|
| 100 | click the <b outputclass="bold">Add</b> button.
|
|---|
| 101 | This mounts the ISO file and presents it to your Windows
|
|---|
| 102 | guest as a CD-ROM.
|
|---|
| 103 | </p>
|
|---|
| 104 | </li>
|
|---|
| 105 | </ol>
|
|---|
| 106 | <p>
|
|---|
| 107 | Unless you have the Autostart feature disabled in your Windows
|
|---|
| 108 | guest, Windows will now autostart the <ph conkeyref="vbox-conkeyref-phrases/product-name"/> Guest
|
|---|
| 109 | Additions installation program from the Additions ISO. If the
|
|---|
| 110 | Autostart feature has been turned off, choose
|
|---|
| 111 | <filepath>VBoxWindowsAdditions.exe</filepath> from the CD/DVD
|
|---|
| 112 | drive inside the guest to start the installer.
|
|---|
| 113 | </p>
|
|---|
| 114 | <p>
|
|---|
| 115 | The installer will add several device drivers to the Windows
|
|---|
| 116 | driver database and then invoke the hardware detection wizard.
|
|---|
| 117 | </p>
|
|---|
| 118 | <p>
|
|---|
| 119 | Depending on your configuration, it might display warnings
|
|---|
| 120 | that the drivers are not digitally signed. You must confirm
|
|---|
| 121 | these in order to continue the installation and properly
|
|---|
| 122 | install the Additions.
|
|---|
| 123 | </p>
|
|---|
| 124 | <p>
|
|---|
| 125 | After installation, reboot your guest operating system to
|
|---|
| 126 | activate the Additions.
|
|---|
| 127 | </p>
|
|---|
| 128 | </body>
|
|---|
| 129 |
|
|---|
| 130 | </topic>
|
|---|
