Version 3 (modified by, 9 years ago) (diff)


This Page is Under Construction

This page describes how to set up the complete GENI-in-a-Box environments on your computer.

Getting Started

To get started there are a couple things that need to be done prior to development. This includes setting up VirtualBox and the development environment. Instructions for doing both are outlined below. If you have any questions or suggestions about the set up process don't hesitate to send an email to

Installing and Setting Up VirtualBox

  1. VirtualBox can be downloaded from Please make sure you install version 4.1.23 or newer.
  1. Once installed you will need to create a VirtualBox 'machine' with a minimum disc space of 40 GB and ram of 2GB. Instructions on creating a virtual machine are at The VirtualBox 'New Virtual Machine Wizard' will walk you through the steps of creating the virtual machine. Accept the default settings in the wizard except for the base memory size (set this to 2GB or more) and virtual disk size (set this to 40 GB or more).
  1. After the virtual machine is created, select it in the 'Oracle VM VirtualBox Manager' window and click on settings. Under 'Display' settings, turn on 3D acceleration.
  1. Choose the OS you want to develop in. Currently supported versions are Fedora 15 and Ubuntu 10.04.4 LTS Lucid Lynx. Download the OS you want to your computer. Fedora download:
    Ubuntu download:
  1. You can install an OS on the VirtualBox virtual machine you created. To do this select in the Oracle VM VirtualBox Manager widow the virtual machine you just created and click the green arrow labeled Start. Detailed instructions for installing an OS on a virtual machine are at Fedora specific install instructions may be found at During the OS install you'll be asked to create a user account. Give this user account the username gib and give this account administrative privileges.
  1. Install any updates available for the OS.
  1. Change user account settings for gib to be automatically logged in when the system boots. Also, change the screen settings to not lock the screen.

Once the OS of your choice is installed on the virtual machine you are ready to start setting up the development environment.

Setting up the Development Environment

Depending on the OS you chose to develop in, Fedora or Ubuntu as listed above, you will need to follow separate instructions.

Fedora Environment Setup Instructions

Ubuntu Environment Setup Instructions