Debug School

Cover image for Install AWX Ansible Tower
Suyash Sambhare
Suyash Sambhare

Posted on

Install AWX Ansible Tower

AWX provides a web-based user interface, REST API, and task engine built on top of Ansible. It is one of the upstream projects for the Red Hat Ansible Automation Platform.

The AWX Operator

Starting in version 18.0, the AWX Operator is the preferred way to install AWX.

AWX can also alternatively be installed and run in Docker, but this install path is only recommended for development/test-oriented deployments and has no official published release.

Installing the AWX CLI

awx is the official command-line client for AWX.


  • Uses naming and structure consistent with the AWX HTTP API Provides consistent output formats with optional machine-parsable formats
  • To the extent possible, auto-detects API versions, available endpoints, and feature support across multiple versions of AWX.

Potential uses include:

  • Configuring and launching jobs/playbooks
  • Checking on the status and output of job runs
  • Managing objects like organizations, users, teams, etc...

The preferred way to install the AWX CLI is through pip directly from PyPI:

pip3 install awxkit
awx --help

Building the CLI Documentation

To build the docs, spin up a real AWX server, pip3 install sphinx sphinxcontrib-autoprogram, and run:

~ cd awxkit/awxkit/cli/docs
~ TOWER_HOST= TOWER_USERNAME=example TOWER_PASSWORD=secret make clean html
~ cd build/html/ && python -m http.server
Serving HTTP on port 8000 ( ..


Top comments (0)