• 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.
  • Make sure you have added tests for your changes.
  • You must use git commit --signoff for any commit to be merged, 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.


Installation from source or package.


Perform all of the Full testing steps prior to submitting a PR.

Ansible Modules

This project uses the following Ansible modules, and Gilt to manage them.

To bring in updated upstream modules. Update gilt.yml and execute the following:

$ gilt overlay

Move to Red Hat

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

Update Git repo location

The Molecule project has moved:

old location:

new location:

If you have the source checked out you should use git remote set-url origin to point to the new location.

Please follow GitHub’s official changing a remote’s URL guide.

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.