Reporting Bugs And Requesting Features

Ansible bugs should be reported to aftersigning up for a free GitHub account. Before reporting a bug, please use the bug/issue searchto see if the issue has already been reported. This is listed on the bottom of the docs page for any module.

Knowing your Ansible version and the exact commands you are running, and what you expect, saves time and helps us help everyone with their issues more quickly. For that reason, we provide an issue template; please fill it out as completely and as accurately as possible.

To be respectful of reviewers’ time and allow us to help everyone efficiently, please provide minimal well-reduced and well-commented examples versus sharing your entire production playbook. Include playbook snippets and output where possible.

When sharing YAML in playbooks, formatting can be preserved by using code blocks.

If you are not sure if something is a bug yet, you are welcome to ask about something on the mailing list or IRC first.

As we are a very high volume project, if you determine that you do have a bug, please be sure to open the issue yourself to ensure we have a record of it. Don’t rely on someone else in the community to file the bug report for you.

Requesting a feature

The next best way of getting a feature into Ansible is to submit a proposal through the .