Skip to main content

Chef Desktop Requirements

[edit on GitHub]

Estimated time: 1 hour

System Requirements

Chef Desktop utilizes the following system architecture:

  • A Chef Automate Server
  • A Chef Infra Server
  • A developer environment running Chef Workstation
  • One or more “nodes”, which are the Windows or macOS computers that you will manage.

Chef Automate

System requirements:

  • 16 GB of RAM
  • 80 GB of disk space (available to /hab)
  • 4 vCPUs

Operating system requirements:

  • a Linux kernel of version 3.2 or greater
  • systemd as the init system
  • useradd
  • cURL or GNU Wget
  • The shell that starts Chef Automate should have a max open files setting of at least 65535

For more information, see the Chef Automate system requirements.

Chef Infra Server

Chef recommends a single virtual machine instance:

  • 2 CPU cores and 8GB of RAM, which is equivalent to an Amazon EC2 m3.large instance
  • 2MB of disk space on the data partition per managed node

For more information, see Install Chef Infra Server and Chef Infra Server Prerequisites.

Chef Workstation

Recommended system requirements:

  • 4GB of RAM
  • 8GB of disk space

For more information, see Install Chef Workstation.

Developer Environment

Visual Studio Code

Chef does not prescribe any specific editor. However, we highly recommend using Visual Studio Code (VSCode) and the Chef Infra extension for VSCode, which features code generators and helpful features, such as running Cookstyle linting each time you save a recipe.

In addition to VSCode, for this guide you need the following extensions from the Visual Studio Code Marketplace:

Virtualization

Test Kitchen, the environment that you will use for testing your Chef Desktop cookbooks before deploying them to your devices, relies on virtualization. Download VirtualBox and Vagrant to use with Test Kitchen:

VirtualBox
The VirtualBox Base Package is licensed under the GPL V2. (Some parts of VirtualBox, especially libraries, may also be released under other licenses as well.)
VirtualBox Extensions
VirtualBox Extensions is licensed under the VirtualBox Extension Pack Personal Use and Evaluation License (PUEL)
Vagrant
Vagrant is governed by a EULA

Windows Developer Tools

WinSCP
WinSCP lets you transfer files to and from the Linux-based Chef Infra Server to your Windows workstation. You will use this for managing your keys and configurations between machines.

Microsoft Azure

Microsoft Intune
Microsoft Intune is a cloud-based that you will used to capture and push configuration to devices.
Windows Autopilot
Windows Autopilot simplifies the IT-side of managing Windows devices.
Gorilla
Gorilla is an open source project. It is a set of tools for managing applications on Windows computers.
Storage Explorer
Storage Explorer is a free tool from Microsoft for managing your Azure cloud storage resources.

MacOS Developer Tools

Apple Enterprise Developer Account
The Apple Developer Enterprise Program is a program that supports large organizations in developing and deploying proprietary, internal-use apps to their employees.
AutoPkg
AutoPkg is an automation framework for macOS software packaging and distribution, oriented towards the tasks one would normally perform manually to prepare third-party software for mass deployment to managed clients.
Munki
Munki is an open source project from Walt Disney Animation Studios. It is a set of tools for managing applications on macOS computers.
MunkiAdmin
MunkiAdmin is a graphical user interface (GUI) for managing munki repositories
Storage Explorer
Storage Explorer is a free tool from Microsoft for managing your Azure cloud storage resources.

Next: Install Chef Components Last: About Chef Desktop