Shell Plugins ------------- Shell plugins work transparently to ensure that the basic commands Ansible runs are properly formatted to work with the target machine. .. _enabling_shell: Enabling Shell Plugins ++++++++++++++++++++++ You can add a custom shell plugin by dropping it into a ``shell_plugins`` directory adjacent to your play, inside a role, or by putting it in one of the shell plugin directory sources configured in :doc:`ansible.cfg <../config>`. .. warning:: You should not alter the configuration for these plugins unless you have a setup in which the default ``/bin/sh`` is not a POSIX compatible shell or is not availble for execution. .. _using_shell: Using Shell Plugins +++++++++++++++++++ In addition to the default configuration settings in :doc:`../config`, you can use a 'connection variable' :ref:`ansible_shell_type` to select the plugin to use. In this case, you will also want to update the :ref:`ansible_executable` to match. .. seealso:: :doc:`../user_guide/playbooks` An introduction to playbooks :doc:`inventory` Ansible inventory plugins :doc:`callback` Ansible callback plugins :doc:`../user_guide/playbooks_filters` Jinja2 filter plugins :doc:`../user_guide/playbooks_tests` Jinja2 test plugins :doc:`../user_guide/playbooks_lookups` Jinja2 lookup plugins `User Mailing List `_ Have a question? Stop by the google group! `irc.freenode.net `_ #ansible IRC chat channel