Pivotal Cloud Foundry v1.7

Installing Pivotal Cloud Foundry on AWS

Page last updated:

This guide describes how to install Pivotal Cloud Foundry (PCF) on Amazon Web Services (AWS) using the PCF CloudFormation template.

The CloudFormation template for Pivotal Cloud Foundry describes the set of necessary AWS resources and properties. When you create an AWS stack using the PCF template, CloudFormation provisions all the infrastructure that you need to deploy PCF on AWS.

Pivotal strongly recommends using CloudFormation to install PCF on AWS. Contact Pivotal Support if you cannot use CloudFormation for your installation.

Note: The CloudFormation template for Elastic Runtime includes a reference to another CloudFormation template for Ops Manager. For more information on how IaaS user roles are configured for each template, refer to the Pivotal Cloud Foundry IaaS User Role Guidelines topic.

Note: If you are performing an upgrade to PCF 1.7, please review Upgrading Pivotal Cloud Foundry for critical upgrade information.


You must have the following in order to follow the procedure described here:

  • An AWS account that can accommodate the minimum resource requirements for a PCF installation.
  • The appropriate region selected within your AWS account. See the Amazon documentation on regions and availability zones for help selecting the correct region for your deployment.
  • The AWS CLI installed on your machine, and configured with user credentials that have admin access to your AWS account.
  • Sufficiently high instance limits (or no instance limits) on your AWS account. Installing Pivotal Cloud Foundry requires more than the default 20 concurrent instances.
  • A key pair to use with your Pivotal Cloud Foundry deployment. Create a key pair in AWS.
  • A registered wildcard domain for your PCF installation. You will need this registered domain when configuring your SSL certificate and Cloud Controller. See the AWS docs on Creating a Server Certificate for more information.
  • An SSL certificate for your PCF domain. This can be a self-signed certificate, but Pivotal only recommends using a self-signed certificate for testing and development. You should obtain a certificate from your Certificate Authority for use in production. See the AWS docs on SSL certificates for more information.

Install PCF on AWS

Complete the following procedures to install PCF using CloudFormation:

  1. Deploying the CloudFormation Template for PCF on AWS

  2. Launching an Ops Manager Director Instance on AWS

  3. Configuring Ops Manager Director on AWS

  4. (Optional) Installing the PCF IPsec Add-On

  5. Deploying Elastic Runtime on AWS

Delete PCF on AWS

You can use the AWS console to remove an installation of all components, but retain the objects in your bucket for a future deployment:

Additional AWS Configuration

See the following topics for additional AWS configuration information:

Create a pull request or raise an issue on the source for this page in GitHub