reference deployment


Web-based UI, REST API, and task engine for managing Ansible projects

This Quick Start deploys AWX on the AWS Cloud, for users who want to run and manage an Ansible infrastructure on AWS.

AWX is an open-source community project that provides software for managing Ansible projects. AWX is hosted on GitHub and provides a web-based user interface, REST API, and task engine for Ansible.

Ansible is a DevOps tool that automates provisioning, configuration management, application deployment, intra-service orchestration, continuous delivery, and many other IT processes. The visual AWX dashboard lets you schedule and deploy Ansible playbooks, and provides centralized logging, auditing, and system tracking. AWX provides the source code for Ansible Tower, which is the commercial version of AWX.

This Quick Start deploys code from the master branch of the GitHub repository for AWX. You can also choose to deploy code from a fork of the repository.  


This Quick Start was developed by AWS solutions
architects and cloud support engineers.

  •  What you'll build
  •  How to deploy
  •  Cost and licenses
  •  What you'll build
  • Use this Quick Start to automatically set up the following environment on AWS:

    • A highly available architecture that spans two Availability Zones.*
    • A virtual private cloud (VPC) configured with public and private subnets according to AWS best practices, to provide you with your own virtual network on AWS.*
    • An internet gateway to allow access to the internet.*
    • In the public subnets, managed NAT gateways to allow outbound internet access for resources in the private subnets.*
    • In the private subnets, an Amazon Elastic Container Service (Amazon ECS) cluster in an Auto Scaling group across the two Availability Zones.
    • In the private subnets, an Amazon Relational Database Service (Amazon RDS) PostgreSQL database.
    • An AWS CodeBuild project to build the AWX project from the official AWX Github repository.

    *  The template that deploys the Quick Start into an existing VPC skips the tasks marked by asterisks and prompts you for your existing VPC configuration.

  •  How to deploy
  • To build your AWX environment on AWS, follow the instructions in the deployment guide. The deployment process includes these steps:

    1. If you don't already have an AWS account, sign up at
    2. Create an OAuth token for AWS CodeBuild to access GitHub.
    3. Launch the Quick Start. Each deployment takes about 45 minutes. You can choose from two options:
    4. Test the deployment by accessing the AWX endpoint and opening the AWX dashboard.

    To customize your deployment, you can configure subnets, specify backup and maintenance settings for the Amazon RDS database, and set AWX credentials. You can also download the AWS CloudFormation templates that automate the deployment and customize them for your specific scenario.

    Amazon may share user-deployment information with the AWS Partner that collaborated with AWS on the Quick Start.  

  •  Cost and licenses
  • You are responsible for the cost of the AWS services and AWS Marketplace AMI used while running this Quick Start. 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.

    Ansible, which is installed as part of the deployment, is licensed under the GNU General Public License version 3.

    AWX is open-source software. It is distributed under the Apache version 2.0 license and is free to use.