Deploy OpenShift on AWS into a new VPC

For details and step-by-step instructions, see the deployment guide.

For additional Quick Starts, see the complete catalog.


This Quick Start sets up a cloud architecture and deploys Red Hat OpenShift Container Platform on AWS.

Red Hat OpenShift Container Platform is based on Docker-formatted Linux containers, Google Kubernetes orchestration, and Red Hat Enterprise Linux (RHEL).

The Quick Start includes AWS CloudFormation templates that build the AWS infrastructure using AWS best practices, and then pass that environment to Ansible playbooks to build out the OpenShift environment. The deployment provisions OpenShift master instances, etcd instances, and node instances in a highly available configuration.

This deployment also includes AWS Service Broker, which provides direct access to AWS services on the Red Hat OpenShift Container Platform.

  • What you'll build

    • A single virtual private cloud (VPC) that spans three Availability Zones, with one private and one public subnet in each Availability Zone.*
    • An Internet gateway to provide Internet access to each subnet.*
    • In one of the public subnets, an Ansible config server instance.
    • In the private subnets:
      • Three OpenShift master instances in an Auto Scaling group
      • Three OpenShift etcd instances in an Auto Scaling group
      • A variable number of OpenShift node instances in an Auto Scaling group

    * The template that deploys the Quick Start into an existing VPC skips the tasks marked by asterisks.

    For details, see the Quick Start deployment guide.

    Request AWS credits for this deployment
  • Deployment details

    Deploy Red Hat OpenShift Enterprise on AWS by following a few easy steps:

    1. Sign up for a Red Hat subscription.
    2. If you don't already have an AWS account, sign up for one at
    3. Launch the Quick Start. You can choose from two options:
      - Deploy into a new VPC 
      - Deploy into an existing VPC 
      The deployment takes about 1.5 hours.
    4. Verify your deployment using the OpenShift Command Line Interface (CLI), and connect to the OpenShift web console.

    To customize your deployment, you can configure infrastructure settings, OpenShift nodes, and the Ansible Playbook version to use.   

    For complete details, see the Quick Start deployment guide.

    Request AWS credits for this deployment
  • Cost and licenses

    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 the Quick Start.

    The AWS CloudFormation template for this Quick Start includes configuration parameters that you can customize. Some of these settings, such as instance type, will affect the cost of deployment. For cost estimates, see the pricing pages for each AWS service you will be using. Prices are subject to change.

    This Quick Start requires a Red Hat subscription.

    Request AWS credits for this deployment