Skip to main content

Chef Workstation App

The Chef Workstation App (CWA) is an early release desktop application that provides additional services for Chef Workstation:

  • Update checking and notifications
  • Chef Workstation version information

Additional features and integrations will be rolled out in future updates.

Running the Chef Workstation App


Launch Chef Workstation App from the Chef Workstation folder in the Start menu.


Start Chef Workstation App by running the command chef-workstation-app.


  1. Chef Workstation App requires a running display manager with support for system tray icons.
  2. On some distributions you may need to install additional libraries. The post-install message shown when you install the Chef Workstation package from the terminal will tell you which – if any – additional libraries are required to run Chef Workstation App.


Start Chef Workstation App from your Applications folder.

Disabling Automatic Update Checks

To disable CWA’s automatic update checking, add or modify the enable setting under updates in config.toml:


Setting Update Channel

To set the channel used for update checking, bring up the CWA tray app menu (Windows/Linux) or the application menu (Mac) and select “About Chef Workstation”.

Select the “Channel” button and choose your preferred channel. This will trigger an immediate update check.

Edit this page on GitHub

Thank you for your feedback!


Search Results