Local Setup with Chef

This section describes how to set up Cuneiform locally on your machine. In addition to fetching and compiling the Cuneiform source code it creates executables in suitable locations, installing Cuneiform for all users.


This guide assumes you are running an Ubuntu Linux 14.04. While later versions of Ubuntu should work as well, it is not recommended to run this cookbook on operating systems other than Ubuntu.


Since Chef installs packages and creates executables in system directories, it requires root access.

If you are not running Ubuntu or do not have root access to your machine, please refer to the Virtual Machine Setup with Chef. If creating a VM is also no option for you, consider downloading the Cuneiform binaries or Compiling from Source.


Please install the following packages:

  • git
  • chefdk


You can do so by entering in a command line terminal:

wget https://opscode-omnibus-packages.s3.amazonaws.com/debian/6/x86_64/chefdk_0.10.0-1_amd64.deb
sudo dpkg -i chefdk_0.10.0-1_amd64.deb
sudo apt-get install git

Download and Install

First, create a directory cookbooks and enter it:

mkdir cookbooks
cd cookbooks

Clone into the cookbooks directory the Cuneiform Chef cookbook by entering:

git clone https://github.com/joergen7/chef-cuneiform.git

Now that we have the Cuneiform cookbook installed, we need to install all dependent cookbooks. This can be done with the berks command:

cd chef-cuneiform
berks vendor ..

Eventually, enter the directory just above the cookbooks directory and run the Chef client:

cd ../..
sudo chef-client -z -r "chef-cuneiform::default"


All applications that may hold a lock on the package management system, like Synaptic, dpkg, or apt-get, must be closed.

Check the success of the installation by observing the output of:

cuneiform --help