Chef Server on AWS
Quick Start Reference Deployment Guide

Step 3. Launch the Chef Stack

This automated AWS CloudFormation template deploys Chef Server into an Amazon VPC. Please make sure that you’ve completed the previous step and have subscribed to the Chef Server AMI in the AWS Marketplace before launching the stack.

  1. Launch the AWS CloudFormation template into your AWS account.

                                                    Chef Server Quick Start launch button

    The template is launched in the US West (Oregon) region by default. You can change the region by using the region selector in the navigation bar.

    This stack takes approximately 35 minutes to create.


    You are responsible for the cost of the AWS services used while running this Quick Start reference deployment. There is no additional cost for using this Quick Start. As of the date of publication, the cost for using the Quick Start with default settings is approximately $0.18 an hour, and you can complete the initial deployment for about $0.18. Prices are subject to change. See the pricing pages for each AWS service you will be using in this Quick Start for full details.

    You can also download the template to use it as a starting point for your own implementation.

  2. On the Select Template page, keep the default URL for the AWS CloudFormation template, and then choose Next.

  3. On the Specify Details page, review the parameters for the template. These are described in the following table.

    Provide values for the KeyPairName and AdminPassword parameters. For all other parameters, the template provides default settings that you can customize.

    Parameter Default Description
    KeyPairName Requires input Public/private key pair, which allows you to connect securely to your instance after it launches. When you created an AWS account, this is the key pair you created in your preferred region.
    AdminEmailAddress admin@localhost.internal Email address for the Chef administrator.
    AdminPassword Requires input Password for the "chefadmin" user for signing in to the Chef workstation and Management Console. This must be a complex password that’s at least 8 characters long.
    ChefNodes 5 Select the number of nodes you want to support (5 to 250).
    IncludeDemoInstances true Keep the default value to include a Chef workstation and demo node. To deploy Chef Server only, set this parameter to false.
    RemoteAdminCIDR Requires input CIDR block or IP for SSH and RDP access. We recommend that you set this value to a trusted CIDR block.
    SubnetCIDR CIDR block for the subnet CIDR.
    VPCCIDR CIDR block for the Amazon VPC.


    You can also download the template and edit it to create your own parameters based on your specific deployment scenario.

  4. On the Options page, you can specify tags (key-value pairs) for resources in your stack and set additional options. When you're done, choose Next.

  5. On the Review page, review and confirm the template settings.

  6. Choose Create to deploy the stack.

  7. Monitor the status of the stack. When the status displays CREATE_COMPLETE, Chef Server is ready.