You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/install.md
+31-36Lines changed: 31 additions & 36 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -27,16 +27,19 @@ We use Chef Habitat to distribute and install Chef Workstation and its component
27
27
See the following guides to install and configure Chef Habitat:
28
28
29
29
-[Install Chef Habitat](https://docs.chef.io/habitat/install_habitat/)
30
-
-[Create a Chef Habitat Builder profile](https://docs.chef.io/habitat/builder_profile/)
30
+
-[Create a Chef Habitat Builder profile](https://docs.chef.io/habitat/builder/saas/builder_profile/)
31
31
32
32
## Install Chef Workstation
33
33
34
34
Chef Workstation supports several installation methods to accommodate different deployment scenarios.
35
35
Installing the Latest Stable Version To install the most recent stable release from the default channel, execute the following command:
36
36
37
-
```shell
38
-
hab pkg install chef/chef-workstation # Installs the latest stable version from the default channel base-2025
37
+
### Installing with Binary Linking (Recommended)
39
38
39
+
The recommended installation method includes binary linking, which creates symbolic links to the package binaries in your system PATH. This enables direct command execution without requiring the full Habitat exec syntax:
The recommended installation method includes binary linking, which creates symbolic links to the package binaries in your system PATH. This enables direct command execution without requiring the full Habitat exec syntax:
After completing the installation, verify that Chef Workstation is correctly installed by checking the version information:
@@ -120,31 +115,7 @@ Note: After installing a Habitat package on Windows, you need to add (use hab cl
120
115
121
116
Chef Workstation provides two primary methods for executing the bundled tools. This section describes each approach and provides guidance on selecting the appropriate method for your use case.
122
117
123
-
### Method 1: Using Habitat Exec
124
-
125
-
The Habitat exec command provides explicit control over which package and version is used to execute a command. This method is recommended when you need to ensure a specific package version is used or when binary linking isn't available.
126
-
The general syntax for the Habitat exec command is as follows:
### Method 2: Using Direct Executables with Binary Linking
118
+
### Method 1: Using Direct Executables with Binary Linking
148
119
149
120
Binary linking creates symbolic links to package executables in a system-wide location, allowing you to invoke tools directly without the Habitat exec prefix. This method provides a more familiar command-line experience similar to traditional installations.
150
121
To enable binary linking during the initial installation, include the binlink flag:
@@ -170,6 +141,30 @@ inspec version
170
141
knife -v
171
142
```
172
143
144
+
### Method 2: Using Habitat Exec
145
+
146
+
The Habitat exec command provides explicit control over which package and version is used to execute a command. This method is recommended when you need to ensure a specific package version is used or when binary linking isn't available.
147
+
The general syntax for the Habitat exec command is as follows:
0 commit comments