VirtualBox Guest Additions: Features, Installation, and Use

Learn what VirtualBox Guest Additions do, how to install them on Windows and Linux guests, configure shared folders, and troubleshoot integration problems.

VirtualBox Guest Additions are software components and device drivers installed inside a virtual machine's guest operating system. They improve communication between the guest and the physical computer running VirtualBox.

This guide explains the host, the VirtualBox application, and the guest, then covers Guest Additions features, installation, shared folders, verification, maintenance, and troubleshooting.

What VirtualBox Guest Additions Are

A host operating system is the operating system installed on the physical computer. The VirtualBox application runs on that host and creates and manages virtual machines. A guest operating system is the operating system installed inside a virtual machine.

Guest Additions are installed in the guest, not only on the host. They include drivers, services, and utilities that allow the guest to work more closely with VirtualBox and the host. The virtual machine can run without them, but input, display, and file-sharing features are generally less convenient.

For example, a Windows or Ubuntu desktop guest may initially require manual input capture. After Guest Additions are installed and the guest is restarted, the mouse can usually move between the guest window and the host desktop more naturally, and the guest display may respond better when the VM window is resized.

Features and Benefits

Feature	What It Changes	Typical Use Case	Guest OS Notes
Mouse pointer integration	Reduces the need to capture and release the pointer manually.	Move the pointer between the VM window and the host desktop.	Behavior depends on the guest desktop and installed version.
Keyboard and input integration	Makes ordinary keyboard and pointer use feel more like using a local computer.	Work in a desktop guest without repeatedly using the Host key.	Some special keys or applications may still behave differently.
Shared folders	Exposes a selected host directory to the guest.	Use project files stored on the host from inside the guest.	Guest permissions and user-group membership can affect access.
Improved video and display support	Can provide better display behavior, including resizing where supported.	Adapt the guest display to a larger or smaller VM window.	Graphics support varies by guest OS and configuration.
Seamless windows	Can show supported guest application windows alongside host desktop windows.	Use a guest application without displaying the entire guest desktop.	Optional and limited in some guest environments.

Available features vary by guest operating system, desktop environment, VirtualBox release, and Guest Additions version. Installing Guest Additions does not guarantee that every feature is available in every guest.

Mouse and Keyboard Interaction

Before Guest Additions

Without mouse integration, clicking inside the VM window may cause VirtualBox to capture the keyboard and mouse. Captured input is directed to the guest instead of the host. To use the host again, you normally press the VirtualBox Host key, which releases the captured input.

The Host key is a special VirtualBox key assigned by the application. Its exact key can depend on the host platform and configuration. The VM window usually displays the assigned key in its status area or input-related menus.

After Guest Additions

With a working Guest Additions installation, mouse pointer integration allows the pointer to move between the guest and host without repeatedly capturing and releasing it. Keyboard focus still follows the active window, so click the appropriate window before typing.

Input integration is not the same as sharing the keyboard with another computer. The guest still receives input only when its window has focus, and some full-screen programs or desktop environments may require special handling.

Shared Folders

A shared folder is a host directory selected for access by a guest VM. VirtualBox presents it inside the guest as a network-like share or as a mounted filesystem, depending on the guest operating system and configuration. It is useful for source code, documents, installers, and other files that need to be used from both systems.

Configure a Shared Folder

Shut down the VM if you want to change its persistent settings, or start the VM if you plan to use the runtime Devices menu.
Open the VM's Shared Folders settings, or use the VM window's Devices menu when the VM is running.
Choose the host folder path that should be exposed.
Choose a share name and configure options such as read-only access, automatic mounting, or availability for the current session when those options are offered.
Start or return to the guest and locate the shared folder using the guest's file manager or mount location.

Guest Additions must be installed and active for the guest-side shared-folder integration. Access can also depend on permissions on the host folder, permissions inside the guest, and membership in a guest group required by that guest's shared-folder implementation.

Do not assume that a shared folder is automatically visible to every guest user. If the folder is configured but cannot be opened, check the guest user's permissions and any required group membership before changing the host folder's permissions.

Install Guest Additions from the VirtualBox Menu

Start the target VM and sign in to the guest operating system.
In the running VM window, choose Devices > Insert Guest Additions CD Image.
VirtualBox mounts the Guest Additions ISO as a virtual optical disc in the guest. A Guest Additions ISO is a virtual CD/DVD image containing installers for supported guest operating systems.
Open the mounted Guest Additions disc in the guest.
Run the installer appropriate for the guest operating system.
Accept the installation location and select or leave optional components according to your needs.
Restart the guest operating system when the installer finishes.

If the guest does not automatically open the disc, use its file manager to open the virtual optical drive. If no disc appears, confirm that the VM is running, that the Devices menu action was used, and that a virtual optical drive is available.

Windows Guest Installation

Start the Windows VM and sign in.
Choose Devices > Insert Guest Additions CD Image.
Open the mounted disc and launch the Windows Guest Additions installer.
Follow the graphical installation wizard. Review the installation location and optional components when shown.
Approve driver installation prompts if Windows displays them and you trust the Guest Additions media.
Complete the wizard and restart Windows.

Restarting is important because display drivers, mouse integration, and supporting services may not become active until Windows loads them during startup.

Ubuntu and Other Linux Guest Installation

Start the Linux VM and sign in to the graphical desktop.
Choose Devices > Insert Guest Additions CD Image.
Open the mounted disc and identify the Linux installer.
Run the installer from the mounted media. You may need to use a terminal and administrative privileges, depending on the distribution and desktop configuration.
If the installer reports missing build requirements, install the compiler or build toolchain, matching kernel headers, and the kernel development packages for the active kernel. Kernel headers are Linux development files used when building kernel modules.
Run the installer again after the prerequisites are available.
Restart the guest.

The Linux installer may build kernel modules specifically for the currently running kernel. A kernel update can therefore require Guest Additions to be rebuilt or reinstalled. Make sure the headers and development packages match the kernel that the guest is actually running, not merely a different installed kernel.

Package names and package-manager commands differ among Ubuntu, other Debian-based distributions, Fedora-based distributions, and other Linux systems. Use the guest distribution's normal package-management tools rather than assuming that one command applies everywhere.

Installation Workflow by Guest Operating System

Guest Type	Installer Method	Potential Requirements	Restart Needed
Windows	Open the mounted ISO and run the graphical installer.	Permission to install drivers and approval of driver prompts when displayed.	Yes
Ubuntu or other Linux	Open the mounted ISO and run the Linux installer.	Compiler/build tools, matching kernel headers, and kernel development packages may be required.	Yes
Other supported guests	Use the installer supplied for that guest operating system.	Requirements depend on the OS, kernel, desktop, and Guest Additions release.	Usually

Verify the Installation

Move the mouse from the guest window toward the host desktop and back. Confirm that manual capture and Host-key release are no longer needed for ordinary pointer movement.
Resize the VM window. Check whether the guest display adapts to the new dimensions or otherwise shows improved video behavior.
Open the configured shared folder from the guest. Confirm that the expected files are visible and that the intended read or write permissions apply.
Confirm that the guest was rebooted after installation.
Check the guest's running services, loaded modules, or system information using the tools appropriate for that operating system. These should indicate that Guest Additions components are active.
If a feature is missing, confirm that the guest desktop supports it and that the installed Guest Additions release is compatible with the VirtualBox application.

Compatibility and Maintenance

Use a Guest Additions release compatible with the installed VirtualBox version whenever possible. The ISO inserted by the VirtualBox application is normally the appropriate starting point for that installation.

Updates to VirtualBox, the guest operating system, or a Linux guest kernel can affect Guest Additions. After an update, test pointer integration, display resizing, and shared folders again. A Linux kernel update may require rebuilding the Guest Additions kernel modules.

Some graphical capabilities, including seamless windows and particular resizing behavior, are unavailable or limited in certain guest operating systems, desktop environments, graphics configurations, or versions. A missing feature is not always evidence of an installation failure.

Common Problems and Fixes

Symptom	Likely Cause	Recommended Check or Fix
The Guest Additions CD does not appear.	The ISO was not inserted, the VM has no usable virtual optical drive, or another disc is mounted.	Confirm the VM is running, choose Devices > Insert Guest Additions CD Image again, check the optical drive, and retry the mount.
Mouse integration does not work.	The guest was not restarted, installation failed, or the versions are incompatible.	Restart the guest, confirm installation completed, check VirtualBox and Guest Additions compatibility, and consider guest desktop support.
A configured shared folder cannot be opened.	Guest Additions are inactive, the host path is wrong, or guest permissions are insufficient.	Verify the shared-folder settings, confirm Guest Additions are active, check guest permissions and required group membership, then restart or remount if needed.
The Linux installer cannot build modules.	Build tools or packages matching the active kernel are missing.	Install the compiler/build toolchain, matching kernel headers, and kernel development packages. Boot the expected kernel after a recent update and run the installer again.
Display resizing or seamless windows is unavailable.	The feature is unsupported, the guest was not rebooted, graphics settings are unsuitable, or releases are incompatible.	Verify installation and reboot status, review guest graphics settings, check guest OS support, and confirm compatible releases.

Practical Examples

Improving Input in a Desktop VM

A user running an Ubuntu or Windows desktop guest installs Guest Additions and restarts the VM. The pointer can then usually leave the VM window without manually releasing captured input with the Host key.

Accessing Project Files

A developer selects a host project directory in Shared Folders settings and gives it a share name. From the guest, the developer opens the corresponding shared-folder location instead of repeatedly copying files through virtual media or another transfer method.

Using a Larger Display

After installation and reboot, a user enlarges the VM window. If the guest OS and graphics configuration support resizing, the guest display adapts to the new dimensions.

Installing in Ubuntu

A user inserts the Guest Additions ISO, opens it in Ubuntu, runs the Linux installer, installs missing build tools and matching kernel headers if requested, and reboots. The user then tests pointer integration, display resizing, and shared-folder access.

Key Exam Notes

Guest Additions are installed inside the guest operating system.
The host OS runs VirtualBox; the guest OS runs inside the VM.
The Host key releases captured keyboard and mouse input when integration is unavailable.
Shared folders expose selected host directories to the guest, but guest permissions may limit access.
The menu path for mounting the installation media is Devices > Insert Guest Additions CD Image.
Restart the guest after installation so drivers, services, and modules can load.
Linux installations may require build tools, matching kernel headers, and kernel development packages.
VirtualBox, Guest Additions, guest OS, kernel, and desktop compatibility affects which features work.

For related administration tasks, see starting a virtual machine, installing a guest OS, installing Ubuntu, and VirtualBox features.