====== VirtualBox======

===== External Documentation =====

The best documentation on learning and using VirtualBox is going to be at the [[https://www.virtualbox.org/|VirtualBox]] website.


===== Installation at ICS =====

VirtualBox 6.1 is installed on [[accounts:connecting_to_openlab|ICS Openlab Linux systems]].  It can be added to any research Linux system as well. VirtualBox is not installed in the ICS Windows computing labs as [[accounts:vmware | VMware]] is used for certain ICS courses. 
===== Running VirtualBox=====

There are no special privileges required but you must have a local X server running.

From any managed Linux host where virtualbox is installed, you may run `virtualbox`.  


====Jupyterhub@ICS ====

Open [[https://hub.ics.uci.edu|Jupyterhbu@ICS]] in your preferred browser.

Login with your ICS username and password. 

From the Launcher: select //Desktop//.

Within the desktop open a Terminal.   

You can then ssh to openlab from there: 
<code>
ssh -Y  USERNAME@openlab.ics.uci.edu
</code>
Off campus access requires the UCI VPN.


====Apple/Macintosh====

**Prerequisite**:  Local X server via software such as XQuartz.

You can connect via terminal from your Mac with XQuartz running.  Use the -Y option to enable X11 tunneling to your localhost:

The syntax is:
<code>
ssh -Y  USERNAME@openlab.ics.uci.edu
</code>

Once you sign in with your ICS username and password, VirtualBox is available from /usr/bin/virtualbox.

Off campus access requires ssh keys unless you are using the UCI VPN.


====Microsoft Windows====

Use an ssh client that has an embedded X-server such as [[software:commontools|MobaXterm]]  

=== MobaXterm ===
If you are using MobaXterm, create an ssh session to openlab.ics.uci.edu by clicking on the "Session" icon and then "SSH".

Basic SSH Settings:
  * Remotehost:  openlab.ics.uci.edu
  * Specify username:  YOUR USERNAME

Advanced SSH Settings:
  * X11-Forwarding:  checked

Once you sign in with your ICS username and password, VirtualBox is available from /usr/bin/virtualbox.
Off campus access requires ssh keys unless you are using the UCI VPN.

=== Other Client ===
If you are running another X11 server and SSH client, you can tunnel X11 via ssh by logging into openlab this way:
<code>
ssh -Y USERNAME@openlab.ics.uci.edu
</code>