Ansible Pilot

Build Ansible AWX in Docker containers - Ansible AWX

How to build Ansible AWX in Docker containers in the latest Fedora taking care of the preliminary requirements.

September 21, 2022
Access the Complete Video Course and Learn Quick Ansible by 200+ Practical Lessons

How to build Ansible AWX in Docker containers?

AWX is the Open Source upstream project of the Ansible Automation Controller, included in the Ansible Automation Platform (formerly Ansible Tower). Running in Docker containers to use the modern web-UI and API interface. Running in Docker containers is recommended only for experienced users and developers. I’m Luca Berton and welcome to today’s episode of Ansible Pilot.

Ansible AWX

Ansible AWX supports only the x86_64 operating system:

Ansible AWX is the upstream project of Ansible Automation Controller (formerly Ansible Tower), providing a modern web-UI and API interface to manage Ansible Playbooks, inventories, Credentials, and Vaults between your team in your organization.

Running AWX in local Docker containers allows you to test the AWX web-UI and API to manage Ansible Playbook execution easily. AWX run on Docker is considered for Testing or Development only; the preferred way is via the AWX Operator since version 18.0. This initial configuration sometimes is a roadblock for some Ansible AWX users.

The Best Resources For Ansible


Video Course

Printed Book



How to Build Ansible AWX in Docker containers.

I’m going to show you how to build the latest Ansible AWX in the latest Fedora using Docker containers and the latest receptor image.

The additional software must be installed:

Please note that the latest Docker technology should be installed in the target system, the Docker service must be started, and the current user added to the docker group. Also, the latest docker-compose Python module must be installed for a successful installation.

How to build the Ansible AWX Base Container Image and download the latest Ansible Receptor Image.

Clone the latest stable tag Ansible AWX repository

git clone -b x.y.z

Substitute x.y.z with the latest release version number (for example, 21.5.0).

Configure the inventory (optional) You can customize the inventory parameters pg_password, broadcast_websocket_secret, secret_key, and any other settings you need for your deployment.

The Ansible AWX Base Container Image build the AWX Base Container Image.

$ make docker-compose-build

This command builds the AWX base container image (it takes a while and connects to the internet to download dependencies, packages, and libraries).

After successful execution the docker images the command shows you a new ansible/awx_devel image:

[lberton@ansible awx]$ docker images
REPOSITORY                  TAG       IMAGE ID       CREATED         SIZE   HEAD      4d593fc25fc2   21 hours ago    1.8GB
  1. The Ansible Receptor Image

Download the Receptor Image The process also downloads the latest devel image from the receptor. Verify that the receptor image was successfully downloaded using the docker images command:

[lberton@ansible awx]$ docker images
REPOSITORY                  TAG       IMAGE ID       CREATED         SIZE    devel     981db0fc0f90   7 days ago      233MB

A successful build end with a prompt without any errors.


Now you know how to Build Ansible AWX in Docker containers.

Subscribe to the YouTube channel, Medium, and Website, X (formerly Twitter) to not miss the next episode of the Ansible Pilot.


Learn the Ansible automation technology with some real-life examples in my

My book Ansible By Examples: 200+ Automation Examples For Linux and aws System Administrator and DevOps

BUY the Complete PDF BOOK to easily Copy and Paste the 250+ Ansible code

Want to keep this project going? Please donate

Access the Complete Video Course and Learn Quick Ansible by 200+ Practical Lessons
Follow me

Subscribe not to miss any new releases