Skip to content
Go to file

Latest commit

Obvious fix; these changes are the result of automation not creative thinking.

Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Chef Workstation

Umbrella Project: Chef Workstation

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 Command Line Tool
  • Test Kitchen
  • Cookstyle
  • Various Test Kitchen and Knife plugins for clouds

Getting Started

  1. Download Chef Workstation

  2. Double-click the .dmg or .msi file to start the install process, or use the package manager for your Linux distribution.

  3. 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

  1. 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..


Chef Workstation gives you everything you need to get started with Chef, so you can automate how you audit, configure, and manage applications end environments.