🌐
Ansible
docs.ansible.com › projects › awx-operator › en › latest › user-guide › advanced-configuration › containers-resource-requirements.html
Containers Resource Requirements - Ansible AWX Operator Documentation
--- spec: ... task_resource_requirements: requests: cpu: 100m memory: 128Mi ephemeral-storage: 100M limits: cpu: 2000m memory: 4Gi ephemeral-storage: 500M web_resource_requirements: requests: cpu: 100m memory: 128Mi limits: cpu: 1000m memory: 4Gi ee_resource_requirements: requests: cpu: 100m ...
Discussions

System Requirement for awx - AWX Project - Ansible
Can someone tell me what is the system requirement (at max) for running awx and using it for production. More on forum.ansible.com
🌐 forum.ansible.com
0
June 6, 2019
AWX collections/requirements.yml
Hello all, in one of my AWX projects I have the normal collections directory and the requirements.yml underneath. In the requirements.yml I’m listing a single ansible-galaxy requirement needed. I now need not only forti… More on forum.ansible.com
🌐 forum.ansible.com
3
0
February 24, 2024
AWX Not Reading requirements.yml
I ran into this with a new AWX instance recently after not having updated after about a year and a half. Ended up needing to create an empty galaxy credential and then assign the credential to the organization. More on reddit.com
🌐 r/ansible
16
5
February 4, 2022
What are the Hardware requirements for deploying awx in kubernetes ?
Hi Folks, I’m trying to deploy AWX in a Kubernetes namespace, but the deployment is failing. I’ve already set the namespace resource limits to 50 CPU and 50 GiB. I’m wondering if there are any limits for pods that I should also consider. If so, could you please let me know what limits ... More on forum.ansible.com
🌐 forum.ansible.com
2
0
June 24, 2025
🌐
Ansible Tower
docs.ansible.com › ansible-tower › latest › html › installandreference › requirements_refguide.html
Ansible Documentation
AWX User Guides and Tower User Guides · Japanese: Ansible Tower クイック設定ガイド v3.8.1 · Japanese: Ansible Tower インストールガイド v3.8.1 · Japanese: Ansible Tower インストールおよびリファレンスガイド v3.8.1 · Japanese: Ansible Tower リリースノート ...
🌐
GitHub
github.com › ansible › awx
GitHub - ansible/awx: AWX provides a web-based user interface, REST API, and task engine built on top of Ansible. It is one of the upstream projects for Red Hat Ansible Automation Platform. · GitHub
2 weeks ago - AWX provides a web-based user interface, REST API, and task engine built on top of Ansible. It is one of the upstream projects for Red Hat Ansible Automation Platform. - ansible/awx
Starred by 15.5K users
Forked by 3.7K users
Languages   Python 98.1% | Jinja 0.7% | Makefile 0.5% | Shell 0.3% | HTML 0.2% | CSS 0.1%
🌐
Ansible
docs.ansible.com › projects › awx › en › 24.6.1 › userguide › projects.html
16. Projects — Ansible AWX community documentation
At the end of a Project update, AWX searches for a file called requirements.yml in the roles directory, located at <project-top-level-directory>/roles/requirements.yml. If this file is found, the following command automatically runs: ansible-galaxy role install -r roles/requirements.yml -p <project-specific cache location>/requirements_roles -vvv
🌐
Ansible
docs.ansible.com › projects › awx › en › latest › contributor › API_REQUIREMENTS.html
API Development Requirements — Ansible AWX community documentation
This document defines mandatory API development standards for enterprise-grade Django REST Framework applications based on AWX production patterns. REQUIRED: Comprehensive DRF setup with enterprise-grade defaults:
🌐
Medium
medium.com › swlh › ansible-awx-installation-5861b115455a
Ansible AWX Installation. As you know, automation is one of the… | by Cagri Ersen | The Startup | Medium
April 30, 2020 - So, if you want to use official awx images from dockerhub, you SSL setup that we cover later in this post, cannot be done! As mentioned above, AWX requires a postgreSQL database and installer will automatically create a psql container for it.
🌐
Ansible
forum.ansible.com › archives › awx project
System Requirement for awx - AWX Project - Ansible
June 6, 2019 - Can someone tell me what is the system requirement (at max) for running awx and using it for production.
🌐
Ansible
docs.ansible.com › projects › awx › en › latest
Ansible AWX Documentation — Ansible AWX community documentation
Ansible AWX helps teams manage complex multi-tier deployments by adding control, knowledge, and delegation to Ansible-powered environments. Welcome · Release Notes · Known Issues · Job slicing and limit interactions · Misuse of job slicing can cause errors in job scheduling · Community · AWX Contributor’s Guide · 1. Introduction · 2. Communication · 3. Setting up your development environment · 4. What should I work on? 5. Reporting Issues · Django Development Requirements ·
Find elsewhere
🌐
Ansible
forum.ansible.com › get help
AWX collections/requirements.yml - Get Help - Ansible Forum
February 24, 2024 - Hello all, in one of my AWX projects I have the normal collections directory and the requirements.yml underneath. In the requirements.yml I’m listing a single ansible-galaxy requirement needed. I now need not only fortinet.fortios, but community.general as well.
🌐
GitHub
github.com › ansible › awx › blob › devel › requirements › README.md
awx/requirements/README.md at devel · ansible/awx
Verify ansible-runner's build dependency doesn't conflict with the changes made. OPA-python-client v2.0.3+ requires urllib3 v2.5.0+ but has other compatibility issues that need investigation.
Author   ansible
🌐
Reddit
reddit.com › r/ansible › awx not reading requirements.yml
r/ansible on Reddit: AWX Not Reading requirements.yml
February 4, 2022 -

I'm having issues trying to run a playbook that's stored on our GitHub in my requirements.yml file via AWX. As I run the template, the playbook passes but seems to not even attempt to read the requirements file at all. The collections seem to work when I run it my playbook.yml file, but the goal is to be run some remote playbooks separately as a requirement.

From what I have seen online, requirements.yml is supposed to be placed within the roles directory for AWX to automatically read and run the file. Is there an issue with the structure of the playbook directories? Is possible we are missing a setting in AWX to it see requirements.yml?

🌐
OneUptime
oneuptime.com › home › blog › how to configure ansible tower/awx
How to Configure Ansible Tower/AWX
January 24, 2026 - A complete guide to installing and configuring Ansible Tower or its open-source alternative AWX for enterprise automation workflows.
🌐
Ansible
forum.ansible.com › get help
What are the Hardware requirements for deploying awx in kubernetes ? - Get Help - Ansible
June 24, 2025 - Hi Folks, I’m trying to deploy AWX in a Kubernetes namespace, but the deployment is failing. I’ve already set the namespace resource limits to 50 CPU and 50 GiB. I’m wondering if there are any limits for pods that I should also consider. If so, could you please let me know what limits I should set for the pods to ensure a successful deployment?
🌐
GitHub
github.com › ansible › awx › issues › 11188
What are the prerequisites in terms CPU/RAM for AWX to be installed via awx-operator · Issue #11188 · ansible/awx
October 3, 2021 - [root@localhost awx-operator]# kubectl describe pods awx-demo-d46576-29dfw | grep 'Warning\|Reason' Type Reason Age From Message Warning FailedScheduling 4m6s (x71 over 74m) default-scheduler 0/1 nodes are available: 1 Insufficient cpu, 1 Insufficient memory. This host is a VM and here are the available resources ( I can increase them but I don't know what's required)
Author   ansible
🌐
Ansible
ansible.com › faq
Ansible Collaborative - Frequently asked questions
No. However, all contributions to AWX will require agreement with the Developer Certificate of Origin (DCO) at the time of submission. The text of the DCO can be read in full at developercertificate.org. ... We are pleased to shared there are so many ways to contribute to the Ansible ecosystem.
🌐
HowtoForge
howtoforge.com › home › ansible awx guide: basic usage and configuration
Ansible AWX Guide: Basic Usage and Configuration
In this tutorial, we will show you basic usage of the Ansible AWX. So, you need a server that already has been installed Ansible AWX. We cover some basic configurations of Ansible AWX that you must know, such as setup credentials, inventories, setup and run job templates etc.
🌐
Ansible
docs.ansible.com › projects › awx › en › 24.6.1 › administration › instances.html
8. Managing Capacity With Instances — Ansible AWX community documentation
... The nodes (control, hop, and execution instances) are interconnected via receptor, forming a virtual mesh. Red Hat Enterprise Linux (RHEL) or Debian operating system. Bring a machine online with a compatible Red Hat family OS (e.g. RHEL 8 and 9) or Debian 11. This machine requires a static ...
Top answer
1 of 1
50

Technically speaking, you could put your requirements.yml file anywhere you like as long as you reflect the correct path in your ansible-galaxy install command.

Meanwhile, if you ever want to run your playbooks from Ansible Tower/Awx, I suggest you stick to the Ansible Tower requirements and put your requirements.yml file in <project-top-level-directory>/roles/requirements.yml

Regarding dependencies between roles, ansible-galaxy is able to follow them by itself when they are encountered during installation. So you don't need to specify all of them in your requirements.yml, only top level ones. You just need to specify your dependencies correctly in each external roles.

In meta/main.yml for role1

dependencies:
  - src: https://my.scm.com/my-ansible-roles/role2.git
    scm: git
    version: master
    name: role2
  - src: https://my.scm.com/my-ansible-roles/role3.git
    scm: git
    version: master
    name: role3

In meta/main.yml for role2

dependencies:
  - src: https://my.scm.com/my-ansible-roles/role4.git
    scm: git
    version: master
    name: role4
  - src: https://my.scm.com/my-ansible-roles/role5.git
    scm: git
    version: master
    name: role5

roles/requirements.yml

---    
- src: https://my.scm.com/my-ansible-roles/role1.git
  scm: git
  version: master
  name: role1

To be as exhaustive as possible, this is what I now usually do on my projects to handle dependencies locally as well as local/project only roles

Basic project structure

ansible-project-dir
└─── roles
|    └─── locally-versioned-role1
|    └─── locally-versioned-role2
|    └─── ...
|    └─── requirements.yml
|    └─── .gitignore
└─── ansible.cfg
└─── playbook1.yml
└─── playbook2.yml

ansible.cfg

I force roles search and downloads in the local roles directory by setting roles_path = roles, so user can use ansible-galaxy install without the -p parameter.

roles/requirements.yml

Already discussed above. Just list dependencies to top-level external (i.e. not versioned in the project) as galaxy role name or as git uris. If you need to fully checkout those roles to later make git commits/push on them, you can use ansible-galaxy install -g -f -r roles/requirements

roles/.gitignore

# Ignore everything in roles dir
/*
# Except:
# the .gitignore file
!.gitignore
# the requirements file
!requirements.yml
# Readme if you have one
!README.md
# and any specific role we want to version locally
!locally-versioned-role*/


Top answer
1 of 2
4

@SwiperNo, I feel your pain. Reading your question, I can see that you have the right aspects for using galaxy with AWX. In my experience, and long hours of testing / troubleshooting, the following worked for me:

  1. A gitlab or github project with a "collections" folder and a "requirements.yml" within it.
  2. Contents of the requirements.yml might be:
--- 
collections:
- name: chocolatey.chocolatey
  source: https://galaxy.ansible.com
  1. Setup AWX with a "Source Control" credential using a token (Token generated from Gitlab/Github)

  2. Setup an AWX Project with the "Source Control Type" as "Git" and use the "Source Control Credential" created in step 3. I also ticked the option "Update Revision on Launch" to update the Git source in the cache a runtime.

  3. Ensure you have a PersistentVolume attached to the AWX instance. The Git source and collections need to cache it locally from what I understand and believe this could be part of your problem. See the following link re PersistentVolume, you can add the config to the awx.yml file, which you would have used to build the K3s instance at the begining. https://docs.ansible.com/automation-controller/4.0.0/html_zh/administration/operator_advanced_configurations.html#persist-projects-directory

  4. Lastly, I would recommend enabling verbose debugging within the template and see if there are errors which pertain to caching or the requirements.yml.

For reference, AWX build using K3s. https://github.com/ansible/awx-operator#persisting-projects-directory

2 of 2
1

Install the ansible-galaxy command if it is not already installed.

You can install it using the following command:

pip3 install ansible-galaxy

Navigate to your project directory and run the ansible-galaxy command to download the collections specified in the collections/requirements.yml file.

For example, if your requirements.yml file contains the VMware collection, you can run the following command:

ansible-galaxy collection install -r collections/requirements.yml

/!\ I'm not an expert with AWX with k3s but it may be help you

Ref to this: ansible docs AWX will detect it and run the needed ansible-galaxy command for you. Make sure that collection download has not been disabled in your awx/tower settings on the AWX console.