|Source Repository:||Repository:Gentoo Portage Tree|
Summary: A desktop virtualization package from Oracle Corporation that allows you to run a guest operating system (Linux, Windows or other) on your Linux system.
- Install Guest System Tools ISO
- Install extension module packages
- Build without any graphic frontend
- Build VBoxVolInfo that needs devicemapper from sys-fs/lvm2.
- Enable building of SDK
- Controls installation of special USB udev rules.
- Build and install the VirtualBox webservice
Glossary of Terms
- Host O/S
- system running on computer you are actually on;
- Guest O/S
- system installed within VirtualBox;
- Guest Additions
- drivers for the Guest O/S.
VirtualBox is also available as a binary package. If you wish to use the binary version see:
app-emulation/virtualbox-bin (package not on wiki - please add)
The binary package contains extensions which are not available with the source package.
# echo "app-emulation/virtualbox-extpack-oracle PUEL" >> /etc/portage/package.license/virtualbox # emerge app-emulation/virtualbox
Make sure that user running X session belongs to
vboxguest group. Create group when it does not exist. Add user to the group. That will enable :
- Shared clipboard;
- Display resizing;
- Seamless mode;
- Drag & Drop.
# groupadd vboxguest # gpasswd -a ''user'' vboxguest
You must enable
additions USE flag when you intend to install Windows as a guest O/S. That will also install the ISO image containing all necessary Windows guest drivers.
If you want to run Funtoo GNU/Linux as a guest O/S, emerge
app-emulation/virtualbox-guest-additions in the Funtoo GNU/Linux guest O/S. For other GNU/Linux, please refer to VirtualBox documentation.
You will not be able to run and use VirtualBox as a regular user if you are not a member of the
# gpasswd -a ''user'' vboxusers
You must re-log so changes take effect.
Required and optional modules must be loaded before launching VirtualBox. You can do that as root or upon boot.
vboxnetflt are optional.
# modprobe vboxdrv # modprobe vboxnetadp # modprobe vboxnetflt
Upon boot OpenRC
modules="vboxdrv vboxnetadp vboxnetflt"
Upon boot systemd
# echo 'vboxdrv' >> /etc/modules-load.d/virtualbox.conf # echo 'vboxnetadp' >> /etc/modules-load.d/virtualbox.conf # echo 'vboxnetflt' >> /etc/modules-load.d/virtualbox.conf
Each time a new kernel is installed,
vboxdrv kernel module must be recompiled. To ensure Portage knows about that, look at
/var/lib/module-rebuild/moduledb. The following record must be present.
emerge @module-rebuild will recompile VirtualBox driver after installation of new kernel.
It is strongly recommended to install
sys-kernel/dkms. This package keeps track of Linux kernel changes. It recompiles
vboxdrv if necessary.
latest releases of virtualbox have a volatile NVRAM and this makes an EFI guest boot troublesome. To workaround this following steps required:
- remove any CD images (like systemrescuecd) from the VM settings
- start the VM
- wait for the countdown or press Esc immediately to reach the EFI shell
edit startup.nshto open the full-screen editor
"fs0:\EFI\Funtoo Linux [GRUB]\grubx64.efi"(including the double quotes, since the path contains spaces)
CTRL-s(maybe twice) to save and confirm saving by pressing Enter
- quit editor by pressing
resetto reboot the machine (or kill the VM and boot it using the GUI)
- wait for the countdown or press Enter to immediately run the startup.nsh script