Installation Methods
AWX offers two primary installation methods, each designed for different use cases:AWX Operator
Recommended for productionDeploy AWX on Kubernetes or OpenShift using the official AWX Operator. This is the preferred installation method for production environments.
Docker Compose
Development and testing onlyRun AWX locally using Docker Compose. This method is designed for development, testing, and demonstration purposes only.
Which Method Should I Choose?
- Production Deployment
- Development & Testing
Use AWX OperatorIf you need a production-ready AWX deployment with:
- High availability
- Scalability
- Enterprise-grade reliability
- Kubernetes/OpenShift infrastructure
The AWX Operator provides automated deployment, upgrades, and lifecycle management.
Installation Version Notes
If you’re installing an older release of AWX (prior to 18.0), the installation instructions have changed. For version-specific instructions, refer to the appropriate branch in the GitHub repository. For example, for AWX 17.0.1, see: https://github.com/ansible/awx/blob/17.0.1/INSTALL.md
Migration from Local Docker
If you’re attempting to migrate an older Docker-based AWX installation (version 17.0.1 or earlier), see the data migration documentation for instructions on migrating to the development environment.System Requirements
Before proceeding with installation, ensure your system meets the necessary requirements:Requirements
Review system requirements, dependencies, and prerequisites for both installation methods.
Next Steps
Review requirements
Check the requirements page to ensure your system meets all prerequisites.
Choose installation method
Select either AWX Operator for production or Docker Compose for development.
Additional Resources
Getting Help
If you need assistance with AWX installation or configuration:- Community Forum: Create a topic using the AWX tag on the Ansible Forum
- Matrix Chat: Join the Ansible Community Matrix
- GitHub Issues: Report bugs or request features on the AWX GitHub repository
For a full list of all the ways to communicate with the Ansible Community, see the AWX Communication guide.