Skip to main content

Checks playbooks for practices and behavior that could potentially be improved

Project description

PyPI version Ansible-lint rules explanation Discussions pre-commit


ansible-lint checks playbooks for practices and behavior that could potentially be improved. As a community-backed project ansible-lint supports only the last two major versions of Ansible.

Visit the Ansible Lint docs site

Using ansible-lint as a GitHub Action

This action allows you to run ansible-lint on your codebase without having to install it yourself.

# .github/workflows/ansible-lint.yml
name: ansible-lint
    branches: ["main", "stable", "release/v*"]
    name: Ansible Lint # Naming the build is important to use it as a status check
    runs-on: ubuntu-latest
      - uses: actions/checkout@v4
      - name: Run ansible-lint
        uses: ansible/ansible-lint@main # or version tag instead of 'main'

For more details, see ansible-lint-action.


Please read Contribution guidelines if you wish to contribute.


The ansible-lint project is distributed as GPLv3 due to use of GPLv3 runtime dependencies, like ansible and yamllint.

For historical reasons, its own code-base remains licensed under a more liberal MIT license and any contributions made are accepted as being made under original MIT license.


ansible-lint was created by Will Thames and is now maintained as part of the Ansible by Red Hat project.

Project details

Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ansible_lint-24.5.0.tar.gz (525.5 kB view hashes)

Uploaded Source

Built Distribution

ansible_lint-24.5.0-py3-none-any.whl (303.7 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page