Welcome!
Ansible is a simple, flexible, and powerful automation tool. Like any powerful tool, there are many ways to use it, some better than others.
This document aims to gather good and best practices from Ansible practitioners and experience from multiple Ansible projects.
Those guidelines are opinionated and are based on the experience of many projects. They are not meant to be followed blindly if they don’t fit the reader’s specific use case or needs. Take them as an inspiration and adjust them to your needs. If you have good and best practices yourself, please share them, we all can learn.
Looking for something specific?
Use the Search at the top!
Versioning
This guide is updated constantly, last update on 01/2026.
-
The Zen of Ansible, some guiding principles to keep in mind when automating with Ansible.
-
Starting a new automation project? A step-by-step guide to set up everything for a successful Ansible project.
-
Tips & Tricks for Ansible, from installation and project setup, roles and collections, up to tasks and variables.
-
Developing, testing and troubleshooting Ansible content. Things to consider when your project is making progress.
-
Useful things when your project reaches production level or you are the Administrator of AAP.
Success
If you have good and best practices yourself, please share them, we all can learn.
Open a documentation request or fork the repository and open a Pull Request afterwards.
Take a look at our Contributing guidelines on how to setup a development environment and additional information.