> For the complete documentation index, see [llms.txt](https://v3noms-organization.gitbook.io/v3noms-byte/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://v3noms-organization.gitbook.io/v3noms-byte/getting-started/how-to-add-vboxlinuxadditions.run-in-debian-based-linux-distros.md).

# How to add VBoxLinuxAdditions.run in Debian Based Linux Distros

To install **VirtualBox Guest Additions** on your Ubuntu or any Debian Linux Distro inside a Virtual machine, follow these steps. 

These additions will enable features like auto-resizing the VM window, shared folders, and better graphics support.

***

#### <mark style="color:red;">**1. Mount the Guest Additions ISO**</mark>

1. Start your Ubuntu VM.
2. In the VirtualBox menu, go to:
   * **Devices → Insert Guest Additions CD image...**
3. If prompted, allow VirtualBox to download the Guest Additions ISO.

***

#### <mark style="color:red;">**2. Update Your Ubuntu System**</mark>

Before proceeding, update your system to ensure you have the latest packages:

```bash
sudo apt update && sudo apt upgrade -y
```

***

#### <mark style="color:red;">**3. Install Required Dependencies**</mark>

The Guest Additions require some tools to be installed first. Install them using the following command:

```bash
sudo apt install build-essential dkms linux-headers-$(uname -r)
```

***

#### <mark style="color:red;">**4. Mount the CD-ROM**</mark>

If the Guest Additions CD doesn't auto-mount, you can manually mount it:

```bash
sudo mkdir /media/cdrom
sudo mount /dev/cdrom /media/cdrom
```

Check the contents of the CD to confirm the mount worked:

```bash
ls /media/cdrom
```

When you'll mount the CD and will try to read it something like ( This is Read-Only ) will pop-up which is completely fine (so don't panic, everything is okay).

***

#### <mark style="color:red;">**5. Run the Installer**</mark>

Run the Guest Additions installer from the mounted ISO:

```bash
sudo /media/cdrom/VBoxLinuxAdditions.run
```

***

#### <mark style="color:red;">**6. Reboot the Virtual Machine**</mark>

After installation completes, reboot the VM:

```bash
sudo reboot
```

***

#### <mark style="color:red;">**7. Verify Auto-Resize**</mark>

After rebooting:

* Resize the VirtualBox window, and Ubuntu should automatically adjust its resolution.
* If it doesn’t work, ensure **Auto-resize Guest Display** is enabled:

  * Go to **View → Auto-resize Guest Display** in VirtualBox.

  <div align="left"><figure><img src="/files/ZX4jLdHxeHekRctRg3PD" alt=""><figcaption></figcaption></figure></div>

***

#### **Troubleshooting**

If the installation fails or auto-resizing doesn’t work:

* Check the installation log for errors:

  ```bash
  cat /var/log/vboxadd-setup.log
  ```
* Ensure the Guest Additions kernel modules are loaded:

  ```bash
  sudo modprobe vboxsf
  ```

This should be resolving any issues you guys were facing.\
Have a nice day.\
\ <mark style="color:green;">**V3nom Signing Off!!**</mark>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://v3noms-organization.gitbook.io/v3noms-byte/getting-started/how-to-add-vboxlinuxadditions.run-in-debian-based-linux-distros.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.