Virtual Machine Setup with Chef

This section describes how to set up Cuneiform inside a Virtual Machine (VM).


Since Cuneiform will run in a Virtual Machine, this setup has no special requirements towards your operating system or Java version. Root access is required only for installing the prerequisites.


The following software has to be available on your system:


When installing Git on Windows, make sure to select Use Git from the Windows Command Prompt when asked to adjust your PATH environment.


If you are running a Debian-based operatin system you can install these packages simply by entering:

sudo dpkg -i chefdk_0.10.0-1_amd64.deb
sudo apt-get install git virtualbox vagrant

Setting up a VM

Clone the chef-cuneiform repository by opening a command line terminal and entering:

git clone


If you are living behind a proxy then update the .kitchen.yml file in the chef-cuneiform folder by updating the provisioner: entry as follows:

  name: chef_zero

Change into the cloned directory and have Chef create a VM by entering:

cd chef-cuneiform
berks install
kitchen converge

The process of setting up the VM may take a few minutes depending on your internet connection. A Ubuntu 14.04 image is fetched from the internet and a Java environment is set up in the VM. All dependencies are installed and the Cuneiform source code is downloaded and compiled.


To destroy the VM again after using it, enter:

kitchen destroy

You can login to the VM by entering

kitchen login

Inside the VM check the success of the installation by observing the output of:

cuneiform --help