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

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

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