Install Chef Workstation tools

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.

Install packages

Follow these instructions to install or upgrade each tool.

Supported platforms

The Chef Workstation tools are supported on Linux x86-64 systems.

Prerequisites

We use Chef Habitat to distribute and install these applications. For more information, see the Chef Habitat documentation.

If you don’t have Chef Habitat installed on your computer, follow these steps:

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
```
If you haven’t already configured Habitat, set up the hab CLI:
```
hab cli setup
```
Follow the prompts in the Habitat CLI. We recommend the following settings:
- Connect to an on-premises Builder instance? No
- Set up a default origin? No
- Set up a default Builder personal access token? No
- Set up a default Habitat Supervisor control gateway secret? No

Berkshelf

To install Berkshelf, follow these steps:

Install the chef/berkshelf package using hab pkg install:

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

Verify that the correct version runs:
```
berks -v
```

chef-cli

To install the chef-cli CLI, follow these steps:

Install the chef/chef-cli package using hab pkg install:

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

Verify that the correct version runs:
```
chef-cli -v
```

Chef Infra Client

To install Chef Infra Client, see the Chef Infra Client install documentation or follow these steps:

Install the chef/chef-infra-client package using hab pkg install:

sudo hab pkg install chef/chef-infra-client --channel unstable --binlink --force

Verify that the correct version runs:
```
chef-client -v
```

Chef Test Kitchen Enterprise

To install Chef Test Kitchen Enterprise, see the Test Kitchen Enterprise install documentation or follow these steps:

Install the chef/chef-test-kitchen-enterprise package using hab pkg install:

sudo hab pkg install chef/chef-test-kitchen-enterprise --channel unstable --binlink --force

Verify that the correct version runs:
```
chef-client -v
```

Chef Vault

To install Chef Vault, follow these steps:

Install the chef/chef-vault package using hab pkg install:

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

Verify that the correct version runs:
```
chef-vault <args>
```

Cookstyle

To install Cookstyle, follow these steps:

Install the chef/cookstyle package using hab pkg install:

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

Verify that the correct version runs:
```
cookstyle -v
```

Fauxhai

To install Fauxhai, follow these steps:

Install the chef/fauxhai package using hab pkg install:

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

Verify that the correct version runs:
```
fauxhai -v
```

Ohai

To install Ohai, follow these steps:

Install the chef/ohai package using hab pkg install:

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

Verify that the correct version runs:
```
ohai -v
```