Upgrade Chef Workstation and its components

Chef Workstation 26.1 and later uses native installers for Debian, RPM, and Windows. To upgrade, install the latest version for your operating system.

Upgrade on Debian-based systems

To upgrade Chef Workstation on a Debian-based system, follow these steps:

1. Download the latest Debian-based installer using one of the following methods:

   • Download for x86-64 (amd64) using wget:

     wget -O "chef-workstation-enterprise-<VERSION>-linux.deb" "https://chefdownload-commercial.chef.io/stable/chef-workstation-enterprise/download?eol=false&license_id=<LICENSE_ID>&m=x86_64&p=linux&pm=deb&v=<VERSION>"
     

   • Download for x86-64 (amd64) using curl:

     curl -o "chef-workstation-enterprise-<VERSION>-linux.deb" "https://chefdownload-commercial.chef.io/stable/chef-workstation-enterprise/download?eol=false&license_id=<LICENSE_ID>&m=x86_64&p=linux&pm=deb&v=<VERSION>"
     

   • Download for ARM64 (aarch64) using wget:

     wget -O "chef-workstation-enterprise-<VERSION>-linux.deb" "https://chefdownload-commercial.chef.io/stable/chef-workstation-enterprise/download?eol=false&license_id=<LICENSE_ID>&m=aarch64&p=linux&pm=deb&v=<VERSION>"
     

   • Download for ARM64 (aarch64) using curl:

     curl -o "chef-workstation-enterprise-<VERSION>-linux.deb" "https://chefdownload-commercial.chef.io/stable/chef-workstation-enterprise/download?eol=false&license_id=<LICENSE_ID>&m=aarch64&p=linux&pm=deb&v=<VERSION>"
     

   Replace:

   • <VERSION> with the version number to upgrade to.
   • <LICENSE_ID> with your Chef license ID.

2. Install the new version:

   • On x86-64 (amd64) systems:

     sudo dpkg -i chef-workstation-enterprise-<VERSION>_amd64.deb
     

   • On ARM64 (aarch64) systems:

     sudo dpkg -i chef-workstation-enterprise-<VERSION>_arm64.deb
     

   Replace <VERSION> with the version number of the downloaded package.

Upgrade on RPM-based systems

To upgrade Chef Workstation on an RPM-based system, follow these steps:

1. Download the latest RPM-based installer using one of the following methods:

   • Download for x86-64 (amd64) using wget:

     wget -O "chef-workstation-enterprise-<VERSION>-linux.rpm" "https://chefdownload-commercial.chef.io/stable/chef-workstation-enterprise/download?eol=false&license_id=<LICENSE_ID>&m=x86_64&p=linux&pm=rpm&v=<VERSION>"
     

   • Download for x86-64 (amd64) using curl:

     curl -o "chef-workstation-enterprise-<VERSION>-linux.rpm" "https://chefdownload-commercial.chef.io/stable/chef-workstation-enterprise/download?eol=false&license_id=<LICENSE_ID>&m=x86_64&p=linux&pm=rpm&v=<VERSION>"
     

   • Download for ARM64 (aarch64) using wget:

     wget -O "chef-workstation-enterprise-<VERSION>-linux.rpm" "https://chefdownload-commercial.chef.io/stable/chef-workstation-enterprise/download?eol=false&license_id=<LICENSE_ID>&m=aarch64&p=linux&pm=rpm&v=<VERSION>"
     

   • Download for ARM64 (aarch64) using curl:

     curl -o "chef-workstation-enterprise-<VERSION>-linux.rpm" "https://chefdownload-commercial.chef.io/stable/chef-workstation-enterprise/download?eol=false&license_id=<LICENSE_ID>&m=aarch64&p=linux&pm=rpm&v=<VERSION>"
     

   Replace:

   • <VERSION> with the version number to upgrade to.
   • <LICENSE_ID> with your Chef license ID.

2. Install the new version:

   • On x86-64 (amd64) systems:

     sudo dnf install chef-workstation-enterprise-<VERSION>.x86_64.rpm
     

     Alternatively:

     sudo rpm -Uvh chef-workstation-enterprise-<VERSION>.x86_64.rpm
     

   • On ARM64 (aarch64) systems:

     sudo dnf install chef-workstation-enterprise-<VERSION>.aarch64.rpm
     

     Alternatively:

     sudo rpm -Uvh chef-workstation-enterprise-<VERSION>.aarch64.rpm
     

   Replace <VERSION> with the version number of the downloaded package.

Upgrade on Windows

To upgrade Chef Workstation on Windows, follow these steps:

1. Download the latest Windows installer:

   Invoke-WebRequest -Uri "https://chefdownload-commercial.chef.io/stable/chef-workstation-enterprise/download?eol=false&license_id=<LICENSE_ID>&m=x86_64&p=windows&pm=msi&v=<VERSION>" -OutFile "chef-workstation-enterprise-<VERSION>_x86_64.msi"
   

   Replace:

   • <VERSION> with the version number to upgrade to.
   • <LICENSE_ID> with your Chef license ID.

2. Install the new version:

   msiexec /i chef-workstation-enterprise-<VERSION>_x86_64.msi
   

   Replace <VERSION> with the version number of the downloaded package.

Next steps

• Set up Workstation
• Add a license

See also

• Install Chef Workstation
• Uninstall Chef Workstation