Skip to main content

Ansible automation made simple

AWX provides a web-based user interface, REST API, and task engine built on top of Ansible. Manage inventories, launch playbooks, and monitor job execution—all from a modern, intuitive platform.

Get StartedExplore API
AWX Platform

Quick start

Get AWX up and running in minutes. Follow these steps to deploy AWX and run your first Ansible job.

1

Install AWX with the AWX Operator

The recommended way to deploy AWX is using the AWX Operator on Kubernetes. This provides a scalable, production-ready installation.
# Add the AWX Operator to your Kubernetes cluster
kubectl apply -f https://raw.githubusercontent.com/ansible/awx-operator/devel/deploy/awx-operator.yaml
For detailed installation instructions, see the Installation Guide.
2

Create your first organization and project

Once AWX is running, log in to the web interface and create an organization to contain your automation resources. Then add a project that points to your Ansible playbook repository.
# Or use the CLI to create resources
awx organizations create --name "My Organization"
awx projects create --name "My Project" \
  --organization "My Organization" \
  --scm_type git \
  --scm_url "https://github.com/your-org/playbooks.git"
Learn more about Organizations and Projects.
3

Configure an inventory and credentials

Add the hosts you want to manage by creating an inventory, and set up credentials for AWX to authenticate with your infrastructure.You can manage inventories through the web UI or via API:
# Create an inventory
awx inventory create --name "Production" --organization "My Organization"

# Add hosts
awx hosts create --name "web-server-01" --inventory "Production"
See the Inventory Management Guide for more details.
4

Launch a job template

Create a job template that combines your project, inventory, and playbook. Then launch it to execute your Ansible automation.
# Launch a job template via CLI
awx job_templates launch "Deploy Application" --monitor
You can watch the job output stream in real-time through the web interface or CLI. Check out the Running Jobs Guide to learn more.

Explore by topic

Everything you need to master AWX, from core concepts to advanced workflows.

Core concepts

Learn about projects, inventories, credentials, and job templates—the building blocks of AWX automation.

User guide

Step-by-step guides for organizing teams, running jobs, scheduling automation, and configuring notifications.

Workflows

Orchestrate complex automation by chaining multiple jobs together with conditional logic and approval steps.

RBAC

Control who can view, edit, and execute automation resources with granular role-based access control.

API reference

Integrate AWX into your workflows with the comprehensive REST API. Includes authentication, pagination, and filtering.

CLI tools

Install and use the awx command-line tool to manage AWX resources from your terminal.

Key features

Powerful capabilities to scale your Ansible automation across teams and infrastructure.

Job scheduling

Schedule automation to run at specific times or on recurring intervals. Set up maintenance windows and coordinate deployments.

Credential management

Securely store and manage SSH keys, API tokens, and passwords. Integrate with external secret managers like HashiCorp Vault.

Real-time monitoring

Stream job output in real-time as playbooks execute. View detailed task results, timing information, and host status.

Dynamic inventories

Sync inventories from cloud providers, virtualization platforms, and CMDB systems. Keep your infrastructure data up to date automatically.

Resources

Additional resources to help you succeed with AWX.

Installation guides

Deploy AWX with the AWX Operator on Kubernetes or use Docker Compose for development environments.

Architecture overview

Understand how AWX components work together, from the web frontend to the task execution engine.

Contributing guide

Learn how to contribute to AWX, set up your development environment, and submit pull requests.

Community forum

Join the AWX community to ask questions, share knowledge, and connect with other users.

Ready to automate your infrastructure?

Get started with AWX today and bring the power of Ansible automation to your entire team.

Start now