Chef Workstation

Umbrella Project: Chef Workstation

Project State: Active
Issues Response Time Maximum: 14 days
Pull Request Response Time Maximum: 14 days

Chef Workstation installs everything you need to get started using Chef products on Windows, Mac and Linux. It includes:

Chef Workstation App
Chef Infra Client
Chef InSpec
Chef Habitat
Chef Command Line Tool
Test Kitchen
Cookstyle
Various Test Kitchen and Knife plugins for clouds

Getting Started

Download Chef Workstation
Double-click the .dmg or .msi file to start the install process, or use the package manager for your Linux distribution.
Open a terminal, and try out an ad-hoc task. Here's the general usage:

chef-run [flags] <Target host|IP|SSH|WinRM> <Resource> <Resource Name> [properties]

Install the 'ntp' package on 'hostname' over ssh, using password from the environment:

chef-run username:$PASSWORD@hostname package ntp
Create user 'timmy' on 'hostname' over winrm:

chef-run winrm://username@hostname user timmy
Run the recipe 'nginx::passenger' on 'hostname' over ssh on port 2222 using a keyfile:

chef-run ssh://hostname:2222 -i ~/.ssh/id_rsa nginx::passenger

Use chef-run -h for additional information about usage and available flags.

Building Chef-Workstation Packages

We use Omnibus to describe our packaging. Please review chef-workstation/omnibus/README.MD for further details.

Copyright and License

Code released under the Apache license. Images and any trademarked content are Copyright 2018 by Chef Software, Inc..