Skip to main content

Site Map

[edit on GitHub]

This is the documentation for:

  • Chef Infra Server, Chef Infra Client, Chef Workstation, and related tools

Documentation for other Chef products:

This page has links to each topic in this doc set. You can also use the navigation tool or the search box to find what you’re looking for.

If you are new to Chef Infra, we highly recommend the Manage Your Fleet with Chef Infra course on Learn Chef to familiarize yourself with Chef Infra concepts.

If you need documentation for previous versions, see the Docs Archive.

Overview

Platform Overview

Community

About the Community | Contributing | Guidelines | Docs Style Guide | Send Feedback

Packages & Platforms

Packages | Platforms | Supported Versions | Chef Software Install Script | Omnitruck API

Licensing : About Licensing | Accepting License

Chef Compliance

About Chef Compliance | Chef Compliance Guide

Effortless Pattern

Effortless Overview | Quick Start | Effortless Audit | Effortless Config | Variables and Config | What is Scaffolding

Chef Infra

Getting Started

Chef Infra Overview | Quick Start | System Requirements

Chef on Azure Guide : Microsoft Azure | Chef Workstation in Azure Cloud Shell | Microsoft Azure PowerShell | Microsoft Azure Chef Extension | Knife Azure | Knife Azurerm

Chef on Windows Guide : Chef for Microsoft Windows | Chef Infra Client on Windows | Knife Windows

| Chef and Terraform | Glossary | Uninstall

Concepts

Chef Infra Client Overview | Chef Infra Server Overview | chef-repo | Cookbooks | Custom Resources | Nodes

Policy : About Policy | About Policyfiles | Policyfile.rb | Data Bags | Run-lists | Environments | Roles

| Secrets | Authentication | Authorization

Supermarket : Supermarket | Public Supermarket | Private Supermarket | Share Cookbooks

Features

Chef Solo : About Chef Solo | chef-solo (executable) | solo.rb

Ohai : About Ohai | ohai (executable)

| FIPS | Handlers

Management Console : About the Management Console | Configure SAML | Clients | Cookbooks | Data Bags | Environments | Nodes | Roles | Users | manage.rb | chef-manage-ctl

| Push Jobs | Search | Troubleshooting

Setup

Nodes : Install via Bootstrap | chef-client (executable) | client.rb | Upgrades | Security

Chef Infra Server : | Install Chef Infra Server | Install Standalone | Chef Infra Server Prerequisites | Tiered Installation | Install High Availability

| Working with Proxies | Air-gapped Installation | FIPS-mode

Integrations : AWS Marketplace | Google Cloud Platform | VMware

Supermarket : | Install Private Supermarket | Customize Supermarket | supermarket.rb Settings | Backup and Restore | Log Files | Monitoring | knife supermarket | supermarket-ctl | Supermarket API

| Push Jobs

Cookbook Reference

About Cookbooks | Attributes | Files | Libraries

Recipes : About Recipes | Debug Recipes, Client Runs

Recipe DSL : DSL Overview | attribute? | cookbook_name | data_bag | data_bag_item | declare_resource | delete_resource | delete_resource! | edit_resource | edit_resource! | find_resource | find_resource! | platform? | platform_family? | reboot_pending? | recipe_name | resources | search | shell_out | shell_out! | tag, tagged?, untag | value_for_platform | value_for_platform_family | with_run_context | Windows Platform | registry_data_exists? | registry_get_subkeys | registry_get_values | registry_has_subkeys? | registry_key_exists? | registry_value_exists? | Log Entries

| Custom Resources DSL

Resources : About Resources | Common Resource Functionality | Migrating from Definitions | Custom Resources | Custom Resource Guide | All Resources (Single Page) | alternatives | apt_package | apt_preference | apt_repository | apt_update | archive_file | bash | batch | bff_package | breakpoint | build_essential | cab_package | chef_acl | chef_client | chef_client_cron | chef_client_scheduled_task | chef_client_systemd_timer | chef_container | chef_data_bag | chef_data_bag_item | chef_environment | chef_gem | chef_group | chef_handler | chef_node | chef_organization | chef_role | chef_sleep | chef_user | chef_vault_secret | chocolatey_config | chocolatey_feature | chocolatey_package | chocolatey_source | cookbook_file | cron | cron_access | cron_d | csh | directory | dmg_package | dnf_package | dpkg_package | dsc_resource | dsc_script | execute | file | freebsd_package | gem_package | git | group | homebrew_cask | homebrew_package | homebrew_tap | homebrew_update | hostname | http_request | ifconfig | ips_package | kernel_module | ksh | launchd | link | locale | log | macos_userdefaults | macports_package | mdadm | mount | msu_package | notify_group | ohai | ohai_hint | openbsd_package | openssl_dhparam | openssl_ec_private_key | openssl_ec_public_key | openssl_rsa_private_key | openssl_rsa_public_key | openssl_x509_certificate | openssl_x509_crl | openssl_x509_request | osx_profile | package | pacman_package | paludis_package | perl | plist | portage_package | powershell_package | powershell_package_source | powershell_script | python | reboot | registry_key | remote_directory | remote_file | rhsm_errata | rhsm_errata_level | rhsm_register | rhsm_repo | rhsm_subscription | route | rpm_package | ruby | ruby_block | script | service | smartos_package | snap_package | solaris_package | ssh_known_hosts_entry | subversion | sudo | swap_file | sysctl | systemd_unit | template | timezone | user | user_ulimit | windows_ad_join | windows_audit_policy | windows_auto_run | windows_certificate | windows_dfs_folder | windows_dfs_namespace | windows_dfs_server | windows_dns_record | windows_dns_zone | windows_env | windows_feature | windows_feature_dism | windows_feature_powershell | windows_firewall_rule | windows_font | windows_package | windows_pagefile | windows_path | windows_printer | windows_printer_port | windows_security_policy | windows_service | windows_share | windows_shortcut | windows_task | windows_uac | windows_user_privilege | windows_workgroup | yum_package | yum_repository | zypper_package | zypper_repository

| Templates | Cookbook Repo | metadata.rb | Cookbook Versioning | Ruby Guide

Managing Chef Infra Server

Runbook (Single Page) | Backup & Restore | Backend Failure Recovery | Firewalls & Ports | Active Directory & LDAP | Log Files | Monitor | Organizations & Groups | Security | Services | Tuning | Upgrades | Upgrade HA Cluster | Users | chef-server-ctl | chef-backend-ctl | chef-server.rb | Chef Infra Server Optional Settings | opscode-expanderctl | Chef Infra Server API

Push Jobs : knife push jobs | push-jobs-client | push-jobs-client.rb | push-jobs-server.rb | Push Jobs API | Chef Infra Server Sent Events

Release Notes

Chef Infra Client | ChefDK | Chef Infra Server | Chef Manage | Chef Push Jobs | Deprecations

Chef Workstation

About Chef Workstation | Privacy and Telemetry | Install Chef Workstation | Upgrade Lab

Chef Workstation Tools

Berkshelf

chef (executable) : chef env | chef exec | chef gem | chef generate attribute | chef generate cookbook | chef generate file | chef generate recipe | chef generate repo | chef generate resource | chef generate template | chef shell-init

| chef-apply (executable) | chef-run (executable) | chef-shell (executable) | chef-vault (executable) | ChefSpec | Chef Workstation App | config.rb (knife.rb) | Optional config.rb Settings | Cookstyle | Delivery CLI | Foodcritic

Test Kitchen : About Test Kitchen | kitchen (executable) | kitchen.yml | kitchen-vagrant

Knife : About Knife | Setting up Knife | Knife Common Options | config.rb (knife.rb) | knife azure | knife azurerm | knife bootstrap | knife client | knife configure | knife cookbook | knife cookbook site | knife data bag | knife delete | knife deps | knife diff | knife download | knife edit | knife environment | knife exec | knife list | knife node | knife opc | knife raw | knife recipe list | knife role | knife search | knife serve | knife show | knife ssh | knife ssl_check | knife ssl_fetch | knife status | knife supermarket | knife tag | knife upload | knife user | knife windows | knife xargs

| push-jobs-client (executable) | Getting Started | Configure Chef Workstation | Troubleshooting

Chef Desktop

About Chef Desktop | Chef Desktop Requirements | Install Chef Components | Chef Desktop Development Environment | The Chef Desktop Development Pattern | Zero Touch Deployment for MacOS and Windows on Azure | Zero Touch Deployment with MicroMDM for macOS | Chef Desktop Cookbook Reference

Resources

All Resources (Single Page) | chef_client_launchd | mac_admin_control | mac_app_management | mac_automatic_logout | mac_automatic_software_updates | mac_desktop_screensaver | mac_disk_encryption | mac_firewall | mac_password_policy | mac_power_management | rescue_account | windows_admin_control | windows_app_management | windows_automatic_logout | windows_defender | windows_desktop_screensaver | windows_desktop_winrm_settings | windows_disk_encryption | windows_firewall | windows_password_policy | windows_power_management | windows_update_settings

Chef Habitat

Documentation | Tutorials

Chef InSpec

Documentation | Tutorials

Chef Automate

Chef Automate Documentation

Legacy

Workflow

Workflow Basics : Workflow Overview | Configure a Pipeline | Configure a Project | Configure Data Collection | Data Collection with Chef HA | Data Collection without Chef Infra Server | Audit Cookbook

Managing Workflow : build-cookbook (cookbook) | delivery-truck (cookbook) | Manage Dependencies | Manage Secrets | Publish to Multiple Chef Infra Servers | Runners | Workflow w/Bitbucket | Workflow w/Email (SMTP) | Workflow w/GitHub | Workflow w/Slack | Users and Roles | Authentication w/LDAP | Authentication w/SAML | Elasticsearch and Kibana Auth | Delivery Server Backup | Delivery Disaster Recovery | Tuning

Reference : Delivery CLI | delivery.rb | delivery.rb Optional Settings | Workflow DSL

| Chef Automate CTL (Deprecated) | AWS OpsWorks for Chef Automate | Chef Automate for Microsoft Azure

Extension APIs

Handlers

Custom Handlers | Handler DSL | Community Handlers | Compliance DSL

Knife Plugins

Cloud Plugins | Writing Custom Plugins

Ohai Plugins

Custom Plugins | Community Plugins Send Feedback