Installation

System requirements

You can use chef-runner on the following operating systems:

• Mac OS X
• Linux
• Windows
• FreeBSD
• OpenBSD

There is some additional software you will need for chef-runner to work:

• ssh command-line tool
• rsync command-line tool
• Vagrant (optional)
• Test Kitchen (optional)

Mac OS X

If you're on Mac OS X, the easiest way to get chef-runner is via Homebrew:

$ brew tap mlafeldt/formulas
$ brew install chef-runner

Ubuntu & Debian

On Debian-based systems, you can install chef-runner from a Debian package.

The following distributions are supported:

• Ubuntu Precise (12.04 LTS)
• Ubuntu Trusty (14.04 LTS)
• Ubuntu Utopic (14.10)
• Debian Squeeze
• Debian Wheezy
• Debian Jessie

Those packages are hosted on PackageCloud, which supports multiple installation methods.

CentOS 6 & 7

We also provide RPM packages to easily install chef-runner on CentOS.

Those packages are hosted on PackageCloud, which supports multiple installation methods.

Download binaries

There are pre-built binaries of chef-runner for Mac OS X, Linux, Windows, FreeBSD, and OpenBSD. Please download the proper package for your operating system and architecture, then unzip the chef-runner binary to a location included in $PATH.

Source build

Follow these instructions if you want to compile chef-runner from source.