- Desktop or laptop with an Intel Core i7 (or similar) processor running 64-bit Windows 7/8/8.1/10, Mac OS 10.10 (or newer), or a 64-bit Linux variant
8GB RAM or more
12GB free hard disk space minimum. The virtual machine is approximately 9GB. It will expand to 256GB as needed
1. Download software
BitCurator VM or Live CD: https://github.com/BitCurator/bitcurator-distro/wiki/Releases
Current release of VirtualBox: https://www.virtualbox.org/wiki/Downloads
The VirtualBox Extension Pack must be installed on the host for shared folder support, USB 2.0/3.0 support, and support for some NVMe SSDs. Once you’ve installed VirtualBox, use the link below the main download on VirtualBox download site to install the Extension Pack on your host.
2. Unpack the BitCurator Virtual Machine
The BitCurator Virtual Machine is packaged as a tar archive and compressed with gzip. The file will look something like: “BitCurator-X.X.X.tar.gz”
On a Mac (OS X 10.10 or later) or Linux host machine, you can simply double-click on the file to unpack the contents. On a Windows machine, you may need a 3rd party utility such as 7-zip: http://www.7-zip.org/download.html
When using 7-zip, you’ll need to unpack the .tar.gz file. Right click on the .tar.gz file and select “Extract here…” to extract the .tar file. Then right click on the .tar file and select “Extract here…” again. This will extract a directory containing the BitCurator virtual machine disk image (.vbox) and configuration (.vdi) files.
Once you’ve unpacked the archive, you’ll find a directory containing two files (where X.X.X is your downloaded version):
- BitCurator-X.X.X.vbox (the VirtualBox configuration file)
- BitCurator-X.X.X.vdi (the VirtualBox disk image)
Copy this directory to a location of your choosing (inside the “VirtualBox VMs” directory in your home directory is a good place), and start up VirtualBox.
If you’ve never created or used a VM in VirtualBox before, you won’t have a “VirtualBox VMs” directory. Don’t worry – just remember where you extracted the BitCurator directory.
3. Oracle VM VirtualBox Manager
Once you’ve installed VirtualBox and the VirtualBox extension pack, start up VirtualBox. If you’ve never used VirtualBox before, your list of machines (on the left) will be blank.
You may need to right-click on the VirtualBox icon and select “Run as Administrator”. Windows machines with certain administrative controls may prevent you from accessing USB devices (or lock out control of the mouse and keyboard) otherwise.
VirtualBox Manager in Windows
VirtualBox Manager in OSX
Add Virtual Machine
From the menu bar, select the menu item “Machine -> Add…”, and navigate to the folder containing .vbox file that you extracted. Choose that file, and the Virtual Machine should appear in the list within the manager.
Adding a machine (VirtualBox in Windows)
Adding a machine (VirtualBox in OSX)
Configure RAM and Processors
Click on the Settings icon, and select the system tab. We recommend a minimum of 4096MB RAM and 2 processors assigned to the VM. You may wish to change the RAM and number of processors depending on the hardware that you’re running on. For best results, select the largest number in the “green” areas for each.
Two or more processors assigned for VirtualBox are need to support drag-and-drop functionality.
Configuring the VM (VirtualBox in Windows)
Configuring the VM (VirtualBox in OSX)
USB Device Capture
BitCurator depends on a VirtualBox device filter to capture USB devices. In OS X, you’ll find this filter under the USB tab of the “Ports” icon under “Settings”.
In Windows, you’ll find it in the “USB” tab in settings. You don’t need to do anything here, unless you don’t see an entry under “USB Device Filters”.
If you don’t see an entry, select the USB 3.0 radio button, and then create a new filter by clicking on the blue icon to the right of the list.
If you don’t need access to USB devices (for example, if you plan to do analysis of existing born-digital data but no disk imaging), you can delete this filter.
USB Filters (VirtualBox in Windows)
USB Filters (VirtualBox in OSX)
If you wish to move processed materials back to your host machine from the BitCurator VM, you can set up a shared folder that both the host and the VM can write to. In the Shared Folders tab, click the folder with the green “plus” on it to choose a folder on your host machine to share.
Select “Automount” but not “Read Only”. When the machine is booted, the folder will appear in the “Shared Folders and Media” folder on the desktop in the VM.
Shared Folders (VirtualBox in Windows)
Shared Folders (VirtualBox in OSX)
4. Starting the BitCurator Environment (VM)
Click on the green “Start” arrow in the Oracle VM VirtualBox Manager screen to start the BitCurator environment.
You will see a startup screen, and then the BitCurator environment will boot and automatically log in.
If you encounter a menu screen on boot, simply hit the Return key to continue.
If you see an error message mentioning virtualization extensions, or “Intel VT-x”, your host machine’s BIOS does not have the VT-x extensions enabled. You’ll need to reboot your computer, holding down “Del” (or “Esc”, or the “ThinkPad” button, depending on your machine). Once you’re in the BIOS, locate the correct menu entry and enable the “Intel Virtualization Extensions”.
If BitCurator fails to boot for other reasons, it may be due to a “non-optimal setting” detected for your particular hardware. Try powering off the virtual machine, checking your settings, and starting again. If you’re still having a problem, let us know on the BitCurator users group (linked on our wiki at http://wiki.bitcurator.net/).
The BitCurator virtual machine should log in automatically.
If you log out or the machine goes to sleep, the password to log back in is “bcadmin”.
You can also use this password to update installed software, if prompted.