Ansible-lint

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
on:
  pull_request:
    branches: ["main", "stable", "release/v*"]
jobs:
  build:
    name: Ansible Lint # Naming the build is important to use it as a status check
    runs-on: ubuntu-24.04
    steps:
      - uses: actions/checkout@v6
      - name: Run ansible-lint
        uses: ansible/ansible-lint@main # or vX.X.X version
        # optional (see below):
        with:
          args: ""
          gh_action_ref: "<version - e.g. `v25.5.0`>" # Not recommended for non-composite action use
          setup_python: "true"
          python_version: "3.14"
          working_directory: ""
          requirements_file: ""

By default, the workflow uses ansible-lint installed from main. For production or stable workflows, it is recommended to specify a particular release tag (in format v.X.X.X).

All the arguments are optional:

args: Arguments to be passed to ansible-lint command.
gh_action_ref: The git branch, tag, or commit to use for ansible-lint. Not recommended for standard use - only use with composite actions where GH_ACTION_REF is set to the parent action version.
requirements_file: Path to the requirements.yml file to install role and collection dependencies.
setup_python: If python should be installed. Default is true.
python_version: The version of python to install. Default is 3.14.
working_directory: The directory where to run ansible-lint from. Default is github.workspace. Needed if you want to lint only a subset of your repository.

For more details, see ansible-lint-action.

Communication

Refer to the Talk to us section of the Contributing guide to find out how to get in touch with us.

You can also find more information in the Ansible communication guide.

Contributing

Please read Contribution guidelines if you wish to contribute.

Code of Conduct

Please see the Ansible Community Code of Conduct.

Licensing

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.

Authors

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

Release files for ansible-lint 26.9.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ansible-lint 26.9.0
File	Size	Uploaded
ansible_lint-26.9.0.tar.gz	826.4 kB	Sep 22, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for ansible-lint 26.9.0
File	Interpreter	ABI	Platform	Reset
ansible_lint-26.9.0-py3-none-any.whl 341.7 kB Sep 22, 2026	Python 3	none	any	Details

Total release size: 1.2 MB

Release files / ansible_lint-26.9.0.tar.gz

Download URL	ansible_lint-26.9.0.tar.gz
Size	826.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`cb3265888f30815de0dcf0964d34768b45c98bb4361eea7eb42c0342e81b51b4`
BLAKE2b-256 checksum How to use checksums	`09b5841f5ae439a2a039c6045880042d6acd8a8e2fd4e2fb66bc706e321ecb59`
Upload date	Sep 22, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/ansible/ansible-lint
Publishing commit: github.com/ansible/ansible-lint/tree/e7f397ad6dfa20d274afa17cd7bbedd84ed136f5

Workflow

Publishing configuration: github.com/ansible/ansible-lint/blob/e7f397ad6dfa20d274afa17cd7bbedd84ed136f5/.github/workflows/release.yml
Publishing logs: github.com/ansible/ansible-lint/actions/runs/35758341780/attempts/1

Artifact

Subject: ansible_lint-26.9.0.tar.gz
SHA-256 checksum: cb3265888f30815de0dcf0964d34768b45c98bb4361eea7eb42c0342e81b51b4 Verifying attestations

Release files / ansible_lint-26.9.0-py3-none-any.whl

Download URL	ansible_lint-26.9.0-py3-none-any.whl
Size	341.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`4d01903fca9c42f7ce2b366ea5503d0701a27b3c6fdf684276a72888eea57f50`
BLAKE2b-256 checksum How to use checksums	`d623abf992bbe521b4c9cac629d87a5928b35b3a39084ea299df64daed216e55`
Upload date	Sep 22, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/ansible/ansible-lint
Publishing commit: github.com/ansible/ansible-lint/tree/e7f397ad6dfa20d274afa17cd7bbedd84ed136f5

Workflow

Publishing configuration: github.com/ansible/ansible-lint/blob/e7f397ad6dfa20d274afa17cd7bbedd84ed136f5/.github/workflows/release.yml
Publishing logs: github.com/ansible/ansible-lint/actions/runs/35758341780/attempts/1

Artifact

Subject: ansible_lint-26.9.0-py3-none-any.whl
SHA-256 checksum: 4d01903fca9c42f7ce2b366ea5503d0701a27b3c6fdf684276a72888eea57f50 Verifying attestations