{"id":23637039,"url":"https://github.com/ansibleguy/sw_awx","last_synced_at":"2025-11-09T04:30:27.458Z","repository":{"id":53920620,"uuid":"413941615","full_name":"ansibleguy/sw_awx","owner":"ansibleguy","description":"Ansible Role to provision Ansible AWX","archived":false,"fork":false,"pushed_at":"2024-03-18T20:58:34.000Z","size":70,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"latest","last_synced_at":"2024-12-28T06:17:44.942Z","etag":null,"topics":["ansible","ansible-awx","ansible-role","automation","docker","docker-compose","iac","infrastructure-as-code"],"latest_commit_sha":null,"homepage":"","language":"Jinja","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ansibleguy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"ko_fi":"ansible0guy","github":"ansibleguy"}},"created_at":"2021-10-05T18:49:41.000Z","updated_at":"2024-05-11T20:59:27.000Z","dependencies_parsed_at":"2023-02-12T11:20:14.522Z","dependency_job_id":"a7b9c544-3763-4a0e-8826-a714478a9009","html_url":"https://github.com/ansibleguy/sw_awx","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ansibleguy%2Fsw_awx","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ansibleguy%2Fsw_awx/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ansibleguy%2Fsw_awx/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ansibleguy%2Fsw_awx/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ansibleguy","download_url":"https://codeload.github.com/ansibleguy/sw_awx/tar.gz/refs/heads/latest","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239566137,"owners_count":19660271,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ansible","ansible-awx","ansible-role","automation","docker","docker-compose","iac","infrastructure-as-code"],"created_at":"2024-12-28T06:17:29.894Z","updated_at":"2025-11-09T04:30:27.423Z","avatar_url":"https://github.com/ansibleguy.png","language":"Jinja","funding_links":["https://ko-fi.com/ansible0guy","https://github.com/sponsors/ansibleguy","https://ko-fi.com/ansible0guy'"],"categories":[],"sub_categories":[],"readme":"[![AWX](https://raw.githubusercontent.com/ansible/awx-logos/master/awx/ui/client/assets/logo-header.svg)](https://www.ansible.com/products/awx-project/faq)\n\n# Ansible Role - Ansible AWX Setup\nAnsible Role to deploy the [Ansible AWX](https://github.com/ansible/awx) software on a linux server.\n\nThis role is following the [docker installation process](https://github.com/ansible/awx/blob/devel/tools/docker-compose/README.md).\n\n\u003ca href='https://ko-fi.com/ansible0guy' target='_blank'\u003e\u003cimg height='35' style='border:0px;height:46px;' src='https://az743702.vo.msecnd.net/cdn/kofi3.png?v=0' border='0' alt='Buy me a coffee' /\u003e\n\n[![Molecule Test Status](https://badges.ansibleguy.net/sw_awx.molecule.svg)](https://github.com/ansibleguy/_meta_cicd/blob/latest/templates/usr/local/bin/cicd/molecule.sh.j2)\n[![YamlLint Test Status](https://badges.ansibleguy.net/sw_awx.yamllint.svg)](https://github.com/ansibleguy/_meta_cicd/blob/latest/templates/usr/local/bin/cicd/yamllint.sh.j2)\n[![PyLint Test Status](https://badges.ansibleguy.net/sw_awx.pylint.svg)](https://github.com/ansibleguy/_meta_cicd/blob/latest/templates/usr/local/bin/cicd/pylint.sh.j2)\n[![Ansible-Lint Test Status](https://badges.ansibleguy.net/sw_awx.ansiblelint.svg)](https://github.com/ansibleguy/_meta_cicd/blob/latest/templates/usr/local/bin/cicd/ansiblelint.sh.j2)\n[![Ansible Galaxy](https://badges.ansibleguy.net/galaxy.badge.svg)](https://galaxy.ansible.com/ui/standalone/roles/ansibleguy/sw_awx)\n\n**Tested:**\n* Debian 11\n\n## Version\n**[19.3.0](https://github.com/ansible/awx/tree/19.3.0)**\n\nWARNING: The docker-based installation is NOT RECOMMENDED BY ANSIBLE-AWX!\n\n## Install\n\n```bash\n# latest\nansible-galaxy role install git+https://github.com/ansibleguy/sw_awx\n\n# from galaxy\nansible-galaxy install ansibleguy.sw_awx\n\n# or to custom role-path\nansible-galaxy install ansibleguy.sw_awx --roles-path ./roles\n\n# install dependencies\nansible-galaxy install -r requirements.yml\n```\n\n## Functionality\n\n* **Package installation**\n  * Docker =\u003e using [THIS Role](https://github.com/ansibleguy/infra_docker_minimal)\n    * Dependencies\n    * Server\n    * Docker-compose\n  * Nginx =\u003e using [THIS Role](https://github.com/ansibleguy/infra_nginx)\n  * Ansible Client\n\n\n* **Source installation**\n  * Ansible AWX\n\n\n* **Configuration**\n  * Service to start/stop Ansible AWX containers\n  * Fixes for multiple bugs of this version\n  * Backup-Service to pull data from postgres container\n\n\n## Info\n\n* **Note:** this role currently only supports debian-based systems\n\n\n* **Warning:** Not every setting/variable you provide will be checked for validity. Bad config might break the role!\n\n\n* **Warning:** Getting the setup-process to work was 'a little painful'.\u003cbr\u003e\nThis role will most probably only work on the version that it was written for!\n\n## Usage\n\nYou want a simple Ansible GUI? Check-out my [Ansible WebUI](https://github.com/ansibleguy/webui)\n\n### Config\n\nDefine the config as needed:\n\n```yaml\n# must-have\nawx:\n  admin_user: 'someguy'\n  admin_mail: 'awx@template.ansibleguy.net'\n  admin_pwd: !vault |\n      $ANSIBLE_VAULT;1.1;AES256\n      64373031333937633163366236663237623464336461613334343739323763373330393930666331\n      3333663262346337636536383539303834373733326631310a393865653831663238383937626238\n      35396531316338373030353530663465343838373635363633613035356338353366373231343264\n      3437356663383466630a666161363163346533333139656566386466383733646134616166376638\n      35313765356134396130333439663461353336313230366338646165376666313232\n\n  nginx:  # configure the webserver settings =\u003e see: https://github.com/ansibleguy/infra_nginx\n    domain: 'some.guy.net'\n    aliases: ['other.guy.net']\n    ip: '192.168.24.20'\n\n    ssl:\n      mode: 'ca'\n      cert:\n        cn: 'Ansible AWX'\n        country: 'AT'\n        org: 'AnsibleGuy'\n        email: 'awx@template.ansibleguy.net'\n\n  # good to have\n  backup_path: '/var/backups/awx'\n  backup_timer: 'Mon *-*-* 00:00:00'\n  # for date-time format see:\n  #   https://wiki.archlinux.org/title/Systemd/Timers\n  #   https://silentlad.com/systemd-timers-oncalendar-(cron)-format-explained\n\n  # not necessary =\u003e only set if you need them especially\n  settings:\n    pg_username: 'awxpg'\n    pg_password: !vault ...\n    broadcast_websocket_secret: !vault ...\n    secret_key: !vault ...\n\n```\n\nYou might want to use 'ansible-vault' to encrypt your passwords:\n```bash\nansible-vault encrypt_string\n```\n\n### Execution\n\nRun the playbook:\n```bash\nansible-playbook -K -D -i inventory/hosts.yml playbook.yml --ask-vault-pass\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fansibleguy%2Fsw_awx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fansibleguy%2Fsw_awx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fansibleguy%2Fsw_awx/lists"}