Cómo instalar VirtualBox Guest Additions 7.2.20 en GNU/Linux

Instalación e integración de Guest Additions de VirtualBox 7.2 en Windows.

Las Guest Additions de Oracle VirtualBox son un conjunto de controladores y servicios que se instalan dentro del sistema operativo invitado. VirtualBox puede ejecutar una máquina GNU/Linux sin ellas, pero la integración con el host será bastante más limitada.

Con las Guest Additions podemos obtener, según el escritorio y la configuración de la VM, redimensionado automático de pantalla, integración del puntero, portapapeles compartido, arrastrar y soltar, carpetas compartidas y otros mecanismos de comunicación entre host e invitado.

En esta guía vamos a instalar las Guest Additions oficiales de VirtualBox 7.2.20 en una máquina GNU/Linux y, más importante todavía, veremos cómo comprobar que realmente quedaron funcionando. La instalación es sencilla cuando el kernel y sus cabeceras están alineados; casi todos los problemas aparecen precisamente cuando esa parte falla.

Versión comprobada: VirtualBox 7.2.20 (septiembre de 2026). Oracle publica la ISO oficial VBoxGuestAdditions_7.2.20.iso junto con cada versión de VirtualBox. Lo recomendable es mantener host y Guest Additions en la misma rama y, cuando sea posible, en la misma versión.

Descargas oficiales: VirtualBox Downloads y VBoxGuestAdditions_7.2.20.iso.

Si todavía no tienes preparada la máquina invitada, revisa primero nuestra guía para crear una máquina virtual GNU/Linux en VirtualBox.

Antes de comenzar: haz una instantánea

Si la máquina ya tiene información o una versión anterior de Guest Additions, conviene crear un snapshot antes de cambiar controladores del kernel. Oracle también recomienda esta precaución cuando vamos a sustituir Guest Additions que la distribución pudiera traer preinstaladas.

Un snapshot no sustituye a un backup, pero en un laboratorio nos permite regresar rápidamente al estado anterior si la compilación de módulos o la integración gráfica no queda bien.

Qué instala Guest Additions en GNU/Linux

Las Guest Additions no son una sola aplicación. Incluyen módulos del kernel y servicios de usuario que colaboran con VirtualBox. Entre sus funciones encontramos:

integración del puntero del mouse;
cambio dinámico de resolución y mejor integración gráfica;
portapapeles compartido entre host e invitado;
arrastrar y soltar, cuando el entorno de escritorio lo soporta;
carpetas compartidas;
sincronización y servicios de comunicación con el host;
información del sistema invitado accesible desde VirtualBox.

No todas las funciones tienen que estar activadas. Por ejemplo, el portapapeles y el arrastrar y soltar pueden mantenerse deshabilitados y habilitarse únicamente cuando hagan falta.

Comprueba el kernel que estás utilizando

El instalador necesita compilar módulos para el kernel que está ejecutando la VM. Antes de instalar nada comprueba su versión:

uname -r

Ese valor es importante porque las cabeceras instaladas deben corresponder con el kernel en ejecución. Un caso bastante común es actualizar la distribución, instalar headers de un kernel nuevo y continuar arrancado con el kernel anterior. Después el instalador no encuentra un entorno de compilación coherente.

Si acabas de actualizar el kernel, reinicia primero la VM y vuelve a comprobarlo con uname -r.

Preparar Debian, Ubuntu y derivadas

En Debian, Ubuntu y distribuciones derivadas podemos instalar las herramientas básicas de compilación y las cabeceras del kernel con:

sudo apt update
sudo apt install build-essential perl linux-headers-$(uname -r)

Si linux-headers-$(uname -r) no existe, no continúes a ciegas. Comprueba si el sistema está pendiente de reiniciar después de una actualización o si utilizas un kernel diferente al de los repositorios normales.

Preparar Fedora, RHEL, Rocky, AlmaLinux y similares

En sistemas basados en RPM los nombres de paquetes cambian ligeramente. Una preparación típica utiliza:

sudo dnf install gcc make perl kernel-devel kernel-headers

Después verifica que el paquete kernel-devel corresponde con el kernel que devuelve uname -r. En Oracle Linux con UEK el paquete de desarrollo puede ser kernel-uek-devel. Oracle documenta esta diferencia porque no todos los kernels utilizan el mismo paquete.

Insertar VBoxGuestAdditions.iso

Con la VM encendida abre el menú de VirtualBox y selecciona Dispositivos → Insertar imagen de CD de las Guest Additions. VirtualBox montará el archivo VBoxGuestAdditions.iso como una unidad óptica virtual.

El ISO forma parte de la instalación de VirtualBox. En un host GNU/Linux normalmente se encuentra dentro del árbol de instalación de VirtualBox y en Windows suele estar en el directorio del programa. Lo normal es no tener que buscarlo manualmente porque el menú anterior lo conecta automáticamente.

Dependiendo del escritorio, el CD aparecerá montado por sí solo. Si no ocurre, localiza el dispositivo con:

lsblk

y móntalo en un directorio temporal si fuese necesario.

Ejecutar el instalador

Entra al directorio donde está montado el CD y ejecuta:

sudo sh ./VBoxLinuxAdditions.run

El instalador comprobará el sistema, compilará los módulos necesarios e instalará los servicios de Guest Additions. Lee el resultado final: que el script termine no significa automáticamente que todos los módulos hayan podido compilarse.

Si aparecen errores relacionados con headers, GCC, kernel modules o una versión de kernel que no coincide, corrige primero esa causa y vuelve a ejecutar la instalación.

Comprobar que los módulos quedaron cargados

VirtualBox 7.2 proporciona comandos específicos para revisar la instalación. Para comprobar los módulos del kernel:

sudo rcvboxadd status-kernel

Para revisar el servicio de usuario:

sudo rcvboxadd status-user

También podemos observar los módulos relacionados con VirtualBox:

lsmod | grep -i vbox

Si la compilación falló y ya corregiste headers o herramientas, Oracle documenta:

sudo rcvboxadd setup

para volver a configurar y compilar los módulos.

Comprobar la versión instalada

Además de comprobar módulos y servicios, podemos verificar qué versión de Guest Additions ve el invitado:

VBoxControl --version
modinfo vboxguest | grep -E "version|vermagic"

Si el host fue actualizado y el invitado muestra una versión muy anterior, inserta de nuevo la ISO correspondiente y actualiza. Una pequeña diferencia de versión puede seguir funcionando, pero para diagnosticar problemas conviene eliminar esa variable.

Secure Boot y módulos del kernel

Si el GNU/Linux invitado usa UEFI Secure Boot, los módulos de terceros deben cumplir las reglas de firma del kernel. Si vboxguest, vboxsf o los módulos gráficos no cargan después de una instalación aparentemente correcta, revisa dmesg, el estado de Secure Boot y la política de firma de módulos de la distribución antes de desactivarlo a ciegas.

mokutil --sb-state
dmesg | grep -i -E "vbox|secure|module"

¿Es obligatorio reiniciar?

Oracle indica que algunas configuraciones pueden activar las nuevas Guest Additions sin un reinicio completo, pero después de una instalación inicial resulta razonable reiniciar la VM para asegurarnos de que kernel, servicios y sesión gráfica arrancan en un estado limpio:

sudo reboot

Después del reinicio redimensiona la ventana de VirtualBox. Si el escritorio cambia su resolución de forma automática y la integración del mouse funciona correctamente, ya tenemos una primera señal de que la instalación está activa.

Portapapeles compartido y arrastrar y soltar

Instalar Guest Additions no implica que VirtualBox habilite automáticamente todas las funciones de intercambio. Podemos configurarlas desde el menú Dispositivos de la VM.

Para el portapapeles podemos elegir deshabilitado, host a invitado, invitado a host o bidireccional. Conviene habilitar solo lo que necesitemos: un portapapeles compartido es cómodo en un laboratorio, pero también crea un canal adicional entre dos sistemas que quizá queramos mantener aislados.

El comportamiento de arrastrar y soltar puede variar según el entorno de escritorio, el gestor de archivos y si utilizamos X11 o Wayland. Si una función concreta no trabaja, no concluyas inmediatamente que todos los Guest Additions fallaron; primero comprueba módulos, servicios y el resto de la integración.

Carpetas compartidas y el grupo vboxsf

Cuando configuramos una carpeta compartida con automontaje, VirtualBox suele presentarla en GNU/Linux bajo /media con el prefijo sf_. Por ejemplo, una carpeta llamada datos puede aparecer como:

/media/sf_datos

Oracle restringe el acceso a las carpetas automontadas a root y a miembros del grupo vboxsf. Para agregar nuestro usuario:

sudo usermod -aG vboxsf "$USER"

Cierra completamente la sesión y vuelve a entrar para que la nueva pertenencia al grupo se aplique. Puedes comprobarla con:

groups

Guest Additions de Oracle o paquetes de la distribución

Algunas distribuciones incluyen total o parcialmente sus propios paquetes de Guest Additions. Esto puede ser cómodo porque se actualizan junto con el resto del sistema, pero también puede ocurrir que la versión no coincida con la del VirtualBox instalado en el host.

Oracle recomienda mantener las Guest Additions en la misma versión que VirtualBox para obtener mejores resultados y su instalador intenta detectar instalaciones existentes. Lo importante es evitar una mezcla accidental de dos métodos diferentes sin saber qué módulos y servicios están activos.

Si tu distribución integra específicamente VirtualBox y quieres utilizar sus paquetes, sigue su documentación. Si necesitas las funciones y versión exactas del VirtualBox del host, utiliza el ISO correspondiente y verifica el resultado.

Después de actualizar el kernel dejaron de funcionar

Este es uno de los fallos más comunes. Guest Additions utiliza módulos ligados al kernel y una actualización puede dejar temporalmente sin construir los módulos para la nueva versión.

Comprueba primero:

uname -r
sudo rcvboxadd status-kernel

Si faltan los headers del nuevo kernel, instálalos y vuelve a ejecutar:

sudo rcvboxadd setup

Si todavía hay errores, revisa la salida de instalación y los logs del sistema antes de reinstalar paquetes al azar.

Actualizar Guest Additions

Cuando actualizamos VirtualBox en el host, las Guest Additions existentes suelen seguir funcionando porque Oracle mantiene estables las interfaces necesarias. Aun así, la documentación recomienda utilizar la misma versión en host e invitado.

Para actualizar, inserta el nuevo VBoxGuestAdditions.iso y repite el procedimiento de instalación. Después verifica de nuevo módulos y servicios.

Qué comprobar al terminar

Una instalación correcta no se valida solo porque no aparezca un mensaje rojo. Comprueba de forma práctica:

que rcvboxadd status-kernel no reporte un problema;
que el servicio de usuario esté funcionando;
que la resolución responda al tamaño de la ventana cuando corresponda;
que el puntero se integre correctamente;
que portapapeles y carpetas compartidas funcionen si los habilitaste;
que las Guest Additions no estén varios lanzamientos por detrás del VirtualBox del host.

Serie VirtualBox

Este artículo forma parte de nuestra serie dedicada a Oracle VirtualBox:

Fuentes y documentación oficial

Eidy EV

Ingeniero en Ciencias Informáticas con más de 10 años de experiencia en informáticas y ha desempeñado funciones de Arquitecto de software, Analista, Desarrollador de software senior, administrador de redes y sistemas (Sysadmin) y Especialista de seguridad informática.