Skip to content
ARA Records Ansible playbooks and makes them easier to understand and troubleshoot. This is the GitHub mirror for
Branch: master
Clone or download
dmsimard Add GitHub issue templates for bugs and enhancements
Change-Id: I2d98f48f21c332ba3f2043910451e8705a5fb715
Latest commit 99324c5 Jun 8, 2019


ARA Records Ansible

ARA Records Ansible playbooks and makes them easier to understand and troubleshoot.


ARA saves playbook results to a local or remote database by using an Ansible callback plugin and provides an API to integrate this data in tools and interfaces.

This project provides the ARA API as well as the Ansible components.

For the web client interface, see ara-web.


Here's how you can get started from scratch with sane defaults:

# Create a python3 virtual environment and activate it so we don't conflict
# with system or distribution packages
python3 -m venv ~/.ara/virtualenv
source ~/.ara/virtualenv/bin/activate

# Install Ansible, ARA and it's API server dependencies
pip install ansible ara[server]

# Tell Ansible to use the ARA callback plugin
export ANSIBLE_CALLBACK_PLUGINS="$(python -m ara.setup.callback_plugins)"

# Run your playbook as usual
ansible-playbook playbook.yml

If nothing went wrong, your playbook data should have been saved in a local database at ~/.ara/server/ansible.sqlite.

You can browse this data through the API by executing ara-manage runserver and pointing your browser at

That's it !

Live demos

You can find live demos deployed by the built-in ara_api and ara_web Ansible roles at and


Documentation for installing, configuring, running and using ARA is available on

Community and getting help


See contributors on GitHub.


Copyright (c) 2019 Red Hat, Inc.

ARA Records Ansible is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

ARA Records Ansible is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with ARA Records Ansible.  If not, see <>.
You can’t perform that action at this time.