All Articles
On this page
DevOps

How to Install AWX on Kubernetes with the AWX Operator

C
Chandan Kumar
Founder, beCloudReady
January 23, 2024Updated November 1, 20266 min read
How to Install AWX on Kubernetes with the AWX Operator

Install AWX on Kubernetes with the AWX Operator and kustomize, then run your first Ansible playbook from the AWX web interface.

Last updated November 2, 2026. The steps follow the AWX Operator basic install guide and were checked against the repository on that date. The old version of this post used a forked AWX 17 branch and a RHEL 7 host. That method is out of date, so we replaced it.

Before you start

AWX releases are paused. The AWX README says the last release was on July 2, 2024, during "a large scale refactoring." The AWX Operator's last tagged release (2.19.1) is from the same day. Read our short comparison first if you are choosing between AWX and the supported product: Ansible AWX vs Ansible Tower in 2026.

You need:

  • A running Kubernetes cluster. Minikube works for a test.
  • kubectl with a kubeconfig that points at the cluster. Kustomize is built into kubectl.

Step 1: Pick an AWX Operator tag

Open the AWX Operator releases page and pick a tag. The latest tag at the time of writing is 2.19.1. Use the same tag in both places in the next step.

Step 2: Install the operator

Create a file named kustomization.yaml:

apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
  - github.com/ansible/awx-operator/config/default?ref=<tag>
 
images:
  - name: quay.io/ansible/awx-operator
    newTag: <tag>
 
namespace: awx

Apply it:

kubectl apply -k .

Check that the operator pod is running:

kubectl get pods -n awx

To avoid typing -n awx every time, set the namespace for your current context:

kubectl config set-context --current --namespace=awx

Step 3: Create the AWX instance

Create awx-demo.yml in the same folder. The metadata.name becomes the name of your AWX deployment.

---
apiVersion: awx.ansible.com/v1beta1
kind: AWX
metadata:
  name: awx-demo
spec:
  service_type: nodeport

Add the file to resources in kustomization.yaml:

resources:
  - github.com/ansible/awx-operator/config/default?ref=<tag>
  - awx-demo.yml

Apply again:

kubectl apply -k .

The operator now creates the AWX pods and a Postgres database. Watch progress in the operator log:

kubectl logs -f deployments/awx-operator-controller-manager -c awx-manager

When the pods are running, list the service to find the port:

kubectl get svc -l "app.kubernetes.io/managed-by=awx-operator"

AWX is then reachable at http://localhost:<assigned-nodeport>/ on a local cluster such as Minikube. On a cloud cluster, use a node address or set up ingress.

Step 4: Get the admin password

The user is admin. The password is stored in a secret named after your deployment:

kubectl get secret awx-demo-admin-password -o jsonpath="{.data.password}" | base64 --decode ; echo

Run your first playbook

AWX models a playbook run as a few connected objects. Create them in the web interface in this order. The menu layout changes between AWX versions, so use the AWX user guide for the exact screens in your build.

  1. Inventory. Create an inventory, then add the host you want to manage.
  2. Credential. Create a machine credential with the SSH user and key or password for that host.
  3. Project. Create a project that points at a Git repository holding your playbooks.
  4. Job template. Create a job template that ties together the inventory, project, playbook and credential.
  5. Launch. Launch the template and watch the job output. A green result means the playbook ran.

Before you use this for real work

  • The example uses a NodePort service. Put AWX behind an ingress with TLS.
  • Set your own secret key. If the Kubernetes secret is deleted, an auto-generated key cannot be recovered.
  • Back up the Postgres database. The operator supports AWX backup and restore resources.
  • Remember the support situation: AWX is community software with paused releases.

Need help running this?

Running the cluster is usually the harder part. We set up and migrate AKS and EKS clusters at a fixed price: Kubernetes setup and migration. Unsure whether AWX or the supported platform fits? Read Ansible AWX vs Ansible Tower in 2026.

Sources

Frequently asked questions

What is the supported way to install AWX on Kubernetes?

The AWX Operator. You apply a kustomize file that installs the operator, then create an AWX resource that the operator turns into a running AWX instance.

Which AWX version do I get?

The last tagged AWX Operator release is 2.19.1 and the last tagged AWX release is 24.6.1, both from July 2, 2024. Releases are paused during a refactoring.

Is this setup safe for production?

No. The example uses a NodePort service and default settings. It is a demo setup. Plan ingress, TLS, backups and a stored secret key before real use.

AWXAnsibleKubernetesAWX OperatorAutomationIaC