Jump to: navigation, search

VirtualBox/Guest Additions

Clipboard Sharing[edit]

Clipboard sharing is disabled by default in the VirtualBox VM for Whonix-Workstation for security reasons[1]. For Whonix-Gateway, one directional clipboard sharing from host to Whonix-Gateway is enabled and secure[2].

Enable it only temporarily in case you really need it. How?

1) Power off the virtual machine.[3]

2) Go to VirtualBox machine settings -> General -> Advanced -> Shared Clipboard -> Bidirectional -> ok.

3) Power on the virtual machine again.

4) Done.

Shared Folder[edit]

If you are using a default Whonix-Gateway or Whonix-Workstation, please press on expand on the right side.

1) Power off the virtual machine.[3]

2) Go to VirtualBox -> Machine -> Settings -> Shared Folder -> choose a folder -> folder name shared. Choose mount automatically. Press OK.

3) Power on the virtual machine again

4) Done. Files you drop into /mnt/shared in the virtual machine will end up in your chosen host shared folder and vice versa.

[4]

If you are using a Whonix-Custom-Workstation, please click on expand on the right.

1) Power off the virtual machine.[3]

2) Go to VirtualBox -> Machine -> Settings -> Shared Folder -> choose a folder -> folder name shared. Choose mount automatically. Press OK.

3) Create the shared folder.

sudo mkdir -p /mnt/shared

4) Set required access rights.

sudo chmod 777 /mnt/shared

5) Inside the virtual machine, use the following commands to mount the folder.

sudo mount -t vboxsf -o uid=1000,gid=1000 shared /mnt/shared

If you run into a Protocol Error try using a different name, do not use share, use something else, anything, for example, shared.

6) After reboot, you have to repeat the mount command. If you want to mount the folder automatically...

Open /etc/rc.local in an editor with root rights.

If you are using a graphical Whonix or Qubes-Whonix, run:

kdesudo kwrite /etc/rc.local

If you are using a terminal-only Whonix, run:

sudo nano /etc/rc.local

Add before exit 0.

sudo mount -t vboxsf -o uid=1000,gid=1000 shared /mnt/shared

Save.

7) Done. Files you drop into /mnt/shared in the virtual machine will end up in your chosen host shared folder and vice versa.

[5]

Advanced Topics[edit]

Security[edit]

The article The VirtualBox Kernel Driver Is Tainted Crap [6] is talking about the kernel driven (on the host), not guest additions. Opposite statements: one / two.

Installed by Default[edit]

Beginning from Whonix 10 and above, VirtualBox Guest Additions are already installed by default. (Package virtualbox-guest-x11 from Debian's apt repository.)

For technical information:
See blog post, Installing VirtualBox Guest Addition by Default?

Old instructions for Ubuntu Precise[edit]

Moved to Ubuntu.

Installation from VirtualBox CD[edit]

Discouraged until make vbox-disable-timesync compatible with guest additions from virtualbox CD gets implemented.

Alternatives[edit]

  • For file exchange with Whonix without installing guest additions, see File Transfer.
  • To get a higher screen resolution without installing guest additions, see VirtualBox/Higher Screen Resolution without installing VirtualBox Guest Additions
  • To get mouse integration without installing guest additions, use USB tablet in VirtualBox settings. Recommended against, because it requires adding USB controller to VirtualBox. (VirtualBox -> Right click on Virtual Machine -> Settings -> System -> Enable absolute pointing device)

Temporary disable Guest Additions[edit]

This solution is incomplete! In case you want to temporarily disable VirtualBox guest additions, you can try this. A safer solution would be to uninstall them.

Find out which VirtualBox kernel modules are load.

cat /proc/modules

Create a new config file for module blacklisting.

sudo nano /etc/modprobe.d/vbox.conf

And add:

blacklist vboxvideo
blacklist vboxsf
blacklist vboxguest

Safe and reboot. Done.

Footnotes[edit]

  1. To prevent accidentally copying something (non-)anonymous and pasting it in its (non-)anonymous counter part (browser etc.), which would lead to identity correlation.
  2. https://www.whonix.org/old-forum/index.php/topic,986
  3. 3.0 3.1 3.2 Because otherwise you cannot change VirtualBox VM settings.
  4. For your convenience, the shared-folder-help package applied the following steps for you already. a) shared-folder-help.postinst did:
    sudo mkdir -p /mnt/shared
    sudo chmod 777 /mnt/shared
    b) Mounting of the shared folder is done by the mnt-shared-vbox systemd service.
  5. For alternatives, have a look at the source of that information.
  6. http://www.webcitation.org/6HqJVN0br

Random News:

Want to get involved with Whonix? Check out our Contribute page.


Impressum | Datenschutz | Haftungsausschluss

https | (forcing) onion
Share: Twitter | Facebook | Google+
This is a wiki. Want to improve this page? Help welcome, volunteer contributions are happily considered! See Conditions for Contributions to Whonix, then Edit! IP addresses are scrubbed, but editing over Tor is recommended. Edits are held for moderation. Whonix (g+) is a licensee of the Open Invention Network. Unless otherwise noted above, content of this page is copyrighted and licensed under the same Free (as in speech) license as Whonix itself.