Install Chef Workstation and its components

Chef Workstation is modularized to improve user experience and simplify interactions with its components. This divides Chef Workstation into independent parts, enabling users to install, upgrade, and manage specific components individually using Chef Habitat. This approach reduces the complexity of maintaining the entire package.

Supported platforms

Chef Workstation 26 RC3 and its components are supported on Linux x86-64 systems.

Prerequisites

We use Chef Habitat to distribute and install Chef Workstation and its components. If you haven’t already, you must download and install Chef Habitat. For more information, see the Chef Habitat documentation.

Download and install Chef Habitat:

curl https://raw.githubusercontent.com/habitat-sh/habitat/main/components/hab/install.sh | sudo bash -s -- -c stable

Verify Chef Habitat is installed.
```
hab --version
```

Install Chef Workstation

To install Chef Workstation, follow these steps:

Install the Chef Workstation Habitat package:

sudo hab pkg install --binlink --force chef/chef-workstation --channel unstable

Optional: Verify that Chef Workstation and its tools are installed:
```
chef-workstation -v
```
Chef Workstation returns a list of installed packages and their versions.

Install Chef Workstation tools

Follow these instructions to install a Workstation tool.

Install a package using hab pkg install:
```
sudo hab pkg install <PACKAGE_IDENT> --channel unstable --binlink --force
```
Replace <PACKAGE_IDENT> with the package identifier:
- chef/berkshelf
- chef/chef-cli
- chef/chef-infra-client
- chef/chef-test-kitchen-enterprise
- chef/chef-vault
- chef/cookstyle
- chef/fauxhai
- chef/ohai
The --binlink --force options overwrite any existing package symbolic links in the system’s PATH directory with the new version so you can run it directly in the command line.

Verify that the correct version runs:

berks -v
chef-cli -v
chef-client -v
chef-client -v
chef-vault <args>
cookstyle -v
fauxhai -v
ohai -v