Ctrlk

Ansible AWX

Setup Ansible AWX on fresh Kali Host

  1. Install prerequisites. If you're unable to install docker-compose-plugin, please see "Unknown shorthand flag.." for installation help.

sudo apt install docker.io docker-compose docker-compose-plugin ansible npm -y

  1. Create a new user, or add current user to the Docker group. You might need to reload your shell or even restart the host in order to make the changes take effect.

utv-kali :: ~/ ‹24.3.1*› » sudo usermod -aG docker $USER
or
utv-kali :: ~/ ‹24.3.1*› » sudo useradd awx && sudo passwd awx && sudo usermod -aG docker awx && id awx

  1. Find latest version and clone it.

utv-kali :: ~/ » curl -s https://api.github.com/repos/ansible/awx/releases/latest | grep "zipball_url"
utv-kali :: ~/ » git clone -b 24.3.1 https://github.com/ansible/awx.git

  1. Generate keys for pg_password, broadcast_websocket_secret and secret_key. This is optional, if blank it will be generated upon install.

utv-kali :: ~/awx » openssl rand -base64 30
NOfNJdZ+Qg04CQmTfJzXrT0gHdDHj5MTALGtRi5H
utv-kali :: ~/awx ‹24.3.1*› » vim tools/docker-compose/inventory

  1. Build the AWX base image.

utv-kali :: ~/awx ‹24.3.1*› » make docker-compose-build
utv-kali :: ~/awx ‹24.3.1*› » docker images                                                                                                      1 ↵
REPOSITORY                  TAG       IMAGE ID       CREATED              SIZE
ghcr.io/ansible/awx_devel   HEAD      a70774a6fa8d   About a minute ago   1.95GB

  1. Start the containers (COMPOSE_UP_OPTS=-d to detach). If you encounter error "Unknown shorthand flag: 'f' in -f" please see below troubleshooting tips.

  1. Clean and build the UI. This may freeze the host for a few minutes depending on your hardware. If you have 4GB RAM or below OOM Killer will surely kill your process.

Wait a few minutes and you should be able to reach the AWX web UI on https://localhost:8043/#/home.

  1. Lastly create a new superuser, or use the default admin account, to login to the application.

Troubleshooting:

1. Unknown shorthand flag: 'f' in -f

If you get the error unknown shorthand flag: 'f' in -f it's probably because you've only installed docker-compose (version 1) and not docker-compose-plugin (version 2). Verify this by running docker compose version and docker-compose version.

According to Kali Documentation, to install docker-compose-plugin we need to update sources.list, import gpg key and run apt update.

2. Connection refused to web interface

'Connection refused' from host machine to the AWX web interface, even though all containers are up and running, and being able to reach the web interface from the container itself. Restarting the containers did not solve the issue, however doing a full reboot of the host system and then start the containers solved the issue for me.

Container management:

Start / Stop / Restart all AWX containers:

Last updated