Move to Red Hat


During the end of October 2018 the Molecule Project was moved to its new home under Ansible by Red Hat.

How to get involved

New Docker location

For people that use the Docker image, we are now publishing to a new location Molecule on

old location:

new location:

How to use:

docker pull

Release announcements

Want to know about releases, subscribe to ansible-announce list

Talk to us

Join us in #ansible-molecule on freenode, or molecule-users Forum.

The full list of Ansible email lists and IRC channels can be found in the communication page.

Contribution Guidelines

  • We are interested in various different kinds of improvement for Molecule; please feel free to raise an Issue if you would like to work on something major to ensure efficient collaboration and avoid duplicate effort.

  • Create a topic branch from where you want to base your work.

  • Check for unnecessary whitespace with git diff --check before committing. Please see formatting and linting documentation for further commands.

  • Make sure you have added tests for your changes.

  • Although not required, it is good to sign off commits using git commit --signoff, and agree that usage of --signoff constitutes agreement with the terms of DCO 1.1.

  • Run all the tests to ensure nothing else was accidentally broken.

  • Reformat the code by following the formatting section below.

  • Submit a pull request.

Code Of Conduct

Please see our Code of Conduct document.

Pull Request Life Cycle and Governance

  • If your PRs get stuck join us on IRC or add to the working group agenda.

  • The code style is what is enforced by CI, everything else is off topic.

  • All PRs must be reviewed by one other person. This is enforced by GitHub. Larger changes require +2.


Installation from source or package.


Please see Full.


Working with InterSphinx

In the, we define an intersphinx_mapping which provides the base URLs for conveniently linking to other Sphinx documented projects. In order to find the correct link syntax and text you can link to, you can quickly inspect the reference from the command line.

For example, if we would like to link to a specific part of the Ansible documentation, we could first run the following command:

python -m sphinx.ext.intersphinx

And then see the entire Sphinx listing. We see entries that look like:

    AnsibleModule._debug  api/index.html#AnsibleModule._debug

With which we can link out to using the following syntax: