Communicating with the Ansible community
Code of Conduct
All communication and interactions in the Ansible Community are governed by our Community Code of Conduct. Please read and understand it!
Forum
The Ansible Community Forum is a single starting point for questions and help, development discussions, events, and much more. Register to join the community. Search by categories and tags to find interesting topics or start a new one; subscribe only to topics you need!
Take a look at the forum groups and join ones that match your interests. In most cases, joining a forum group automatically subscribes you to related posts.
Want to create a group? Request it in the forum topic.
Real-time chat
For real-time interactions, conversations in the Ansible community happen over two chat protocols: Matrix (recommended) and IRC. The main Matrix and IRC channels exchange messages. This means you can choose whichever protocol you prefer for the main channels.
Note
Although you can choose either Matrix or IRC, please take into account that many Ansible communities use only Matrix.
Join a channel any time to ask questions, participate in a Working Group meeting, or just say hello.
Ansible community on Matrix
To join the community using Matrix, you need two things:
a Matrix account (from Matrix.org or any other Matrix homeserver)
a Matrix client (we recommend Element Webchat)
The Ansible community maintains its own Matrix homeserver at ansible.im
, however, public registration is currently unavailable.
Matrix chat supports:
persistence (when you log on, you see all messages since you last logged off)
edits (Let you fix typos and so on. NOTE Each edit you make on Matrix re-sends the message to IRC. Please try to avoid multiple edits!)
replies to individual users
reactions/emojis
bridging to IRC
no line limits
images
The room links in the General channels or the Working groups list will take you directly to the relevant rooms.
If there is no appropriate room for your community, please create it.
For more information, see the community-hosted Matrix FAQ.
You can add Matrix shields to your repository’s README.md
using the shield in the community-topics repository as a template.
Ansible community on IRC
The Ansible community maintains several IRC channels on irc.libera.chat. To join the community using IRC, you need one thing:
an IRC client
IRC chat supports:
no persistence (you only see messages when you are logged on unless you add a bouncer)
simple text interface
bridging from Matrix
Our IRC channels may require you to register your IRC nickname. If you receive an error when you connect or when posting a message, see libera.chat’s Nickname Registration guide for instructions. To find all ansible
specific channels on the libera.chat network, use the following command in your IRC client:
/msg alias LIST #ansible* -min 5
as described in the libera.chat docs.
Our channels record history on the Matrix side. The channel history can be viewed in a browser - all channels will report an appropriate link to chat.ansible.im
in their Chanserv entrymsg upon joining the room. Alternatively, a URL of the form https://chat.ansible.im/#/room/# {IRC channel name}:libera.chat
will also work, for example - for the #ansible-docs channel it would be https://app.element.io/#/room/#ansible-docs:libera.chat.
General channels
The clickable links will take you directly to the relevant Matrix room in your browser; room/channel information is also given for use in other clients:
Community social room and posting news for the Bullhorn newsletter -
Matrix: #social:ansible.com | IRC: #ansible-social
General usage and support questions -
Matrix: #users:ansible.com | IRC: #ansible
Discussions on developer topics and code related to features or bugs -
Matrix: #devel:ansible.com | IRC: #ansible-devel
Discussions on community and collections related topics -
Matrix: #community:ansible.com | IRC: #ansible-community
- For public community meetings -
Matrix: #meeting:ansible.im | IRC: #ansible-meeting
We will generally announce these on one or more of the above mailing lists. See the meeting schedule
- For public community meetings -
Working group-specific channels
Many of the working groups have dedicated chat channels. See the Working groups for more information.
Regional and Language-specific channels
Comunidad Ansible en español - Matrix: #espanol:ansible.im | IRC:
#ansible-es
Communauté française d’Ansible - Matrix: #francais:ansible.im | IRC:
#ansible-fr
Communauté suisse d’Ansible - Matrix: #suisse:ansible.im | IRC:
#ansible-zh
European Ansible Community - Matrix: #europe:ansible.im | IRC:
#ansible-eu
Meetings on chat
The Ansible community holds regular meetings on various topics on Matrix/IRC, and anyone who is interested is invited to participate. For more information about Ansible meetings, consult the meeting schedule and agenda page.
Working groups
Working Groups are a way for Ansible community members to self-organize around particular topics of interest.
Our community working groups are represented in Matrix rooms and Forum groups.
Many of them meet in chat. If you want to get involved in a working group, join the Matrix room or IRC channel where it meets or comment on the agenda.
AAP Configuration as Code - Matrix: #aap_config_as_code:ansible.com
Amazon (AWS) Working Group - Matrix: #aws:ansible.com | IRC:
#ansible-aws
AWX Working Group - Matrix: #awx:ansible.com | IRC:
#ansible-awx
Azure Working Group - Matrix: #azure:ansible.com | IRC:
#ansible-azure
Community Working Group (including Meetups) - Matrix: #community:ansible.com | IRC:
#ansible-community
Container Working Group - Matrix: #container:ansible.com | IRC:
#ansible-container
DigitalOcean Working Group - Matrix: #digitalocean:ansible.im | IRC:
#ansible-digitalocean
Diversity Working Group - Matrix: #diversity:ansible.com | IRC:
#ansible-diversity
Docker Working Group - Matrix: #devel:ansible.com | IRC:
#ansible-devel
Documentation Working Group - Matrix: #docs:ansible.com | IRC:
#ansible-docs
Galaxy Working Group - Matrix: #galaxy:ansible.com | IRC:
#ansible-galaxy
JBoss Working Group - Matrix: #jboss:ansible.com | IRC:
#ansible-jboss
Kubernetes Working Group - Matrix: #kubernetes:ansible.com | IRC:
#ansible-kubernetes
Linode Working Group - Matrix: #linode:ansible.com | IRC:
#ansible-linode
Molecule Working Group (testing platform for Ansible playbooks and roles) - Matrix: #molecule:ansible.im | IRC:
#ansible-molecule
MySQL Working Group - Matrix: #mysql:ansible.com
Network Working Group - Matrix: #network:ansible.com | IRC:
#ansible-network
Release Management Working Group - Matrix: #release-management:ansible.com
Remote Management Working Group - Matrix: #devel:ansible.com | IRC:
#ansible-devel
Storage Working Group - Matrix: #storage:ansible.com | IRC:
#ansible-storage
VMware Working Group - Matrix: #vmware:ansible.com | IRC:
#ansible-vmware
Windows Working Group - Matrix: #windows:ansible.com | IRC:
#ansible-windows
Ansible developer tools Group - Matrix: #devtools:ansible.com | IRC:
#ansible-devtools
Forming a new working group
The basic components of a working group are:
Group name and charter (why the group exists).
Registered real-time chat channel.
Group of users (at least two!) who will be driving the agenda of the working group.
Dedicated forum group.
The basic responsibilities of a working group are:
Follow the Community Code of Conduct.
Be responsive on your real-time chat channel.
Be responsive on the forum in related topics.
Report semi-regularly on the cool stuff that your working group is working on.
Keep your forum group information updated.
Requesting a working group
Anyone can request to start a Working Group, for any reason.
If you need only a Forum group, request it in the forum topic.
If you also need a real-time chat channel, you can request one.
Ansible Community Topics
The Ansible Community Steering Committee uses the community-topics repository to asynchronously discuss with the Community and vote on Community topics in corresponding issues.
Create a new issue in the repository if you want to discuss an idea that impacts any of the following:
Ansible Community
Community collection best practices and requirements
Other proposals of importance that need the Committee or overall Ansible community attention
Ansible Automation Platform support questions
Red Hat Ansible Automation Platform is a subscription that contains support, certified content, and tooling for Ansible including content management, a controller, UI and REST API.
If you have a question about Ansible Automation Platform, visit Red Hat support rather than using a chat channel or the general project mailing list.
The Bullhorn
The Bullhorn is our newsletter for the Ansible contributor community. You can get Bullhorn updates from the Forum or subscribe to receive it.
If you have any questions or content you would like to share, you are welcome to chat with us in the Ansible Social room on Matrix<https://matrix.to/#/#social:ansible.com>, and mention `newsbot to have your news item tagged for review for the next weekly issue.
Read past issues of the Bullhorn.
Asking questions over email
Note
This form of communication is deprecated. Consider using the Forum instead.
Your first post to the mailing list will be moderated (to reduce spam), so please allow up to a day or so for your first post to appear.
Ansible Announce list is a read-only list that shares information about new releases of Ansible, and also rare infrequent event information, such as announcements about an upcoming AnsibleFest, which is our official conference series. Worth subscribing to!
Ansible AWX List is for Ansible AWX
Ansible Development List is for questions about developing Ansible modules (mostly in Python), fixing bugs in the Ansible Core code, asking about prospective feature design, or discussions about extending Ansible or features in progress.
Ansible Outreach List help with promoting Ansible and Ansible Meetups
Ansible Project List is for sharing Ansible tips, answering questions about playbooks and roles, and general user discussion.
Molecule Discussions is designed to aid with the development and testing of Ansible roles with Molecule.
The Ansible mailing lists are hosted on Google, but you do not need a Google account to subscribe. To subscribe to a group from a non-Google account, send an email to the subscription address requesting the subscription. For example: ansible-devel+subscribe@googlegroups.com
.