====== VirtualBox 3.0 Installation Guide ======
This will explain how to install and configure VirtualBox to run on your Crunchbang system.

There are two version of VirtualBox to choose from:
  * Personal Use and Evaluation License (PUEL)
  * Open Source Edition (OSE)

There is a [[http://www.virtualbox.org/wiki/Editions|webpage]] that details the differences between the two editions, but here is a quick listing of the differences:
  * Remote Display Protocol (RDP) Server
  * USB support
  * USB over RDP

This HOWTO will be using the PUEL edition as it has USB support.

===== Installing VirtualBox 3.0 (PUEL) =====

There are a number of ways to install VirtualBox onto your system.
  - Using apt-get
  - Using GDebi

==== Using apt-get ====
By far the easiest ways to install VirtualBox (and any other software) is by using apt-get in Terminal Emulator.

  - Open up **Terminator** (Openbox Menu > Terminal)
  - At the prompt, type: <code>sudo nano /etc/apt/sources.list</code> or <code>gksudo gedit /etc/apt/sources.list</code>
  - Enter your password.
  - You will need to add the appropriate line to your ///etc/apt/sources.list// file:<code>
deb http://download.virtualbox.org/virtualbox/debian jaunty non-free     ## #! 09.04
deb http://download.virtualbox.org/virtualbox/debian intrepid non-free   ## #! 08.10
deb http://download.virtualbox.org/virtualbox/debian hardy non-free      ## #! 08.04
deb http://download.virtualbox.org/virtualbox/debian gutsy non-free      ## #! 07.10
</code>
  - Put the line that corresponds to your version of CrunchBang in your file, either by retyping it or copying and pasting it. Then save the file.
  - You will need to install the Sun public key to your system. You can do that with one command:<code>wget -q http://download.virtualbox.org/virtualbox/debian/sun_vbox.asc -O- | sudo apt-key add -</code>
  - You will need to update your repositories with the new addition that you made, so go back to **Terminator** and type: <code>sudo apt-get update</code>
  - Now to install virtualbox with apt get, type: <code>sudo apt-get install virtualbox-3.0</code>

That will run the installer and get VirtualBox 3.0 installed on your system. There are some additional steps to get it configured that will be later in the document.

==== Using GDebi ====
This method is the next easiest method to install VirtualBox onto your system.

  - Make sure that you have gdebi installed on your system.<code>sudo apt-get install gdebi</code>
  - Download the appropriate DEB package from VirtualBox at [[http://www.virtualbox.org/wiki/Linux_Downloads|http://www.virtualbox.org/wiki/Linux_Downloads]]
  - Go to your download location.
  - Double-click the //.deb// package that you downloaded. (//virtualbox-3.0_3.0.10-54097_Ubuntu_jaunty_i386.deb// at the time of writing.)
  - Click the '//Install Package//' button in Package Installer
  - Enter your password
  - Click the '//Forward//' button on the Creating group 'vboxusers' box.
  - Click '//Close//' when the installer finishes.
  - Close Package Installer
  - Add yourself to the 'vboxusers' group
    - Go to **Users/Groups** (Openbox Menu > System > Users/Group)
    - Click on the '//Unlock//' button
    - Enter your password and hit the '//Authenticate//' button
    - Select your USERNAME and hit the '//Properties//' button
    - Select the '//User Privileges//' tab
    - Click in the box next to '**Use VirtualBox**' and hit '//OK//'
    - Close '**Users/Groups**'
    - Logout/Login for the Group changes to take effect
  - You are ready to start up VirtualBox.
    - Bring up a Run dialog box
      - Openbox Menu > Run Program
      - Press ALT-F2
    - Type '//VirtualBox//'
  - Accept the Personal Use and Evaluation License (PUEL) by scrolling all the way down and pressing the 'I Agree' button
  - Register your VirtualBox
  - Make some virtual machines!





===== Installing Guest Additions =====
**There are different ways to install Guest Additions; here's a quick one:**

  - Boot your CrunchBang machine in VirtualBox
  - Make sure you have installed the following packages: ''linux-headers-generic build-essential''
  - In VirtualBox, click Devices/Install Guest Additions - this will mount the virtual Guest Additions 'CD' image 
  - Open a terminal and type //sudo thunar// - after entering your password, it will bring up the Thunar file manager with root/sudo access.
  - Browse to the VBOXADDITIONS_* virtual CD that should now be visible in the left column of Thunar
  - Click (or double-click, depending on your settings) on the appropriate file.  For 32-bit CrunchBang, you'd currently use VBoxLinuxAdditions-x86.run
  - A terminal will open and begin the installation.  After it's complete it'll ask you to //'Press Return to close this window . . .'//
  - Restart CrunchBang and you should be good to go.

You can, of course, install via terminal as well, but this may be a touch easier for those with terminal-phobia. =)