Building Dreambox

For information about using Dreambox in your project, see Getting Started.

Build with Vagrant

This project makes use of Vagrant's Multi-Machine feature. I recommend using the Vagrant::Ghost plugin to help manage the host names for these test builds.

Test build

Build the test machine to test the provisioner, added features, etc. This builds a production-ready version of Dreambox for testing updates.

# The test VM is the primary machine
# No need to specify by name
vagrant up
# To SSH into the test box
vagrant ssh

host: http://dreambox.test

Development build

Build the dev machine to install or troubleshoot new software installations. This box builds a base Ubuntu 12.04 box with no packages installed. See the src directory for example compile scripts when adding new software.

# The development VM will not autostart
# It must be specified by name
vagrant up dev
# To SSH into the development box
vagrant ssh dev

host: http://dreambox.dev

Build with Packer

Building with Packer may build a more accurate box, but takes quite a bit longer. If you don't already have Packer installed, you can download it from packer.io or install it via Homebrew by running brew install packer.

# From the dreambox project root
./build

The build script will build the box locally and add it to Vagrant so you can then test with an existing project.

# Use the pre-release version in a project's Vagrantfile
config.vm.box = "dreambox_pre"