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.
kubectlwith a kubeconfig that points at the cluster. Kustomize is built intokubectl.
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: awxApply it:
kubectl apply -k .Check that the operator pod is running:
kubectl get pods -n awxTo avoid typing -n awx every time, set the namespace for your current context:
kubectl config set-context --current --namespace=awxStep 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: nodeportAdd the file to resources in kustomization.yaml:
resources:
- github.com/ansible/awx-operator/config/default?ref=<tag>
- awx-demo.ymlApply 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-managerWhen 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 ; echoRun 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.
- Inventory. Create an inventory, then add the host you want to manage.
- Credential. Create a machine credential with the SSH user and key or password for that host.
- Project. Create a project that points at a Git repository holding your playbooks.
- Job template. Create a job template that ties together the inventory, project, playbook and credential.
- 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
- AWX Operator basic install guide, checked November 2, 2026
- AWX Operator releases
- AWX repository README
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.