Create Ansible AWX Superuser in Docker: Admin Account Setup (Guide)
By Luca Berton · Published 2024-01-01 · Category: troubleshooting
How to create an AWX superuser admin account in Docker containers. Reset passwords, manage users, and troubleshoot AWX authentication with step-by-step examples.
How to Create an Ansible AWX superuser in Docker containers? Ansible AWX superuser has the power to configure all the settings and has unlimited power inside the modern web-UI and API interface. I'm going to show you how to create your first superuser and how to use it. I'm Luca Berton and welcome to today's episode of Ansible Pilot.
Links • Ansible AWX create an admin user
Playbook
How to Create Ansible AWX superuser in Docker containers. I'm going to show you how to create the "sysadmin" superuser in Ansible AWX via Docker containers and how to use it in AWX web-UI and API. Ansible AWX admin user enables you to access the Ansible AWX Web-UI and the Ansible AWX API endpoints that require authentication. The user creation is performed using the docker exec command using the awx-manage utility:
A successful execution to create the example user as follows:
Once a superuser is successfully created you can access the Ansible AWX Web-UI and Ansible API autenticated endopoints.
Ansible AWX UI Login
!Login in the Ansible AWX Web UI
Ansible AWX UI Dashboard
!The Ansible AWX Web UI Dashboard
Ansible AWX API Login
The direct API endpoint is https://localhost:8043/api/login/.
Ansible AWX API Authenticated
The current authenticated user is shown in the top Logged in as example.
!The Ansible AWX API Authenticated
Conclusion Now you know how to create an Ansible AWX superuser in Docker containers.
Creating a Superuser in AWX Docker
Find the AWX web container
Create superuser
Non-interactive creation
Reset Existing Admin Password
AWX on Kubernetes (AWX Operator)
Automate with Ansible
List All Users
Troubleshooting
"That username is already taken"
User already exists. Use changepassword instead.
"No such container: awx_web"
Container names vary. Check with docker ps — might be awx-web or a custom name.
Can't connect to AWX web UI
FAQ
What's the default AWX admin password?
Docker Compose: check docker-compose.yml or .env for AWX_ADMIN_PASSWORD. AWX Operator: stored in Kubernetes secret
How do I create a non-superuser?
Create via awx-manage shell or through the AWX web UI under Organizations > Users.
Related Articles • Ansible Docker Guide • What is Ansible AWX
Category: troubleshooting
Watch the video: Create Ansible AWX Superuser in Docker: Admin Account Setup (Guide) — Video Tutorial