{
  "metadata": {
    "source": "https://docs.ansible.com/ansible/latest/reference_appendices/release_and_maintenance.html",
    "last_validated": "2026-02-08",
    "description": "Ansible-core version compatibility matrix with Python support and lifecycle data"
  },
  "versions": {
    "2.9": {
      "named_version": null,
      "release_date": "2019-10-31",
      "eol_date": "2022-05-23",
      "control_node_python": ["2.7", "3.5", "3.6", "3.7", "3.8"],
      "managed_node_python": ["2.6", "2.7", "3.5", "3.6", "3.7", "3.8"],
      "major_changes": [
        "Last version before collections split",
        "Many modules now deprecated",
        "No longer receives security updates"
      ],
      "min_collection_versions": {},
      "known_issues": [
        "Security vulnerabilities - upgrade immediately",
        "No Python 3.9+ support",
        "EOL since May 2022"
      ],
      "aap_versions": []
    },
    "2.10": {
      "named_version": "2.10",
      "release_date": "2020-09-22",
      "eol_date": "2022-05-23",
      "control_node_python": ["3.6", "3.7", "3.8", "3.9"],
      "managed_node_python": ["2.6", "2.7", "3.5", "3.6", "3.7", "3.8", "3.9"],
      "major_changes": [
        "Major: collections split from core",
        "ansible.builtin namespace introduced",
        "Requires explicit collection installation",
        "Module paths changed"
      ],
      "min_collection_versions": {
        "ansible.posix": "1.0.0",
        "ansible.windows": "1.0.0"
      },
      "known_issues": [
        "Collection installation required for many modules",
        "Import path changes break old playbooks",
        "EOL since May 2022"
      ],
      "aap_versions": []
    },
    "2.11": {
      "named_version": "4.x",
      "release_date": "2021-04-26",
      "eol_date": "2022-11-07",
      "control_node_python": ["3.6", "3.7", "3.8", "3.9"],
      "managed_node_python": ["2.6", "2.7", "3.5", "3.6", "3.7", "3.8", "3.9"],
      "major_changes": [
        "Improved collection support",
        "Better error messages",
        "Performance improvements"
      ],
      "min_collection_versions": {
        "ansible.posix": "1.2.0",
        "ansible.windows": "1.5.0"
      },
      "known_issues": ["EOL since November 2022"],
      "aap_versions": []
    },
    "2.12": {
      "named_version": "5.x",
      "release_date": "2021-11-08",
      "eol_date": "2023-05-31",
      "control_node_python": ["3.8", "3.9", "3.10"],
      "managed_node_python": ["2.6", "2.7", "3.5", "3.6", "3.7", "3.8", "3.9", "3.10"],
      "major_changes": [
        "Python 3.8+ required for control node",
        "Python 2.6/2.7 deprecated for managed nodes",
        "New ansible-core package name"
      ],
      "min_collection_versions": {
        "ansible.posix": "1.3.0",
        "ansible.windows": "1.9.0"
      },
      "known_issues": [
        "Transition to ansible-core package",
        "EOL since May 2023"
      ],
      "aap_versions": []
    },
    "2.13": {
      "named_version": "6.x",
      "release_date": "2022-05-16",
      "eol_date": "2023-11-06",
      "control_node_python": ["3.8", "3.9", "3.10"],
      "managed_node_python": ["2.7", "3.5", "3.6", "3.7", "3.8", "3.9", "3.10"],
      "major_changes": [
        "Continued collection evolution",
        "Module deprecations enforced"
      ],
      "min_collection_versions": {
        "ansible.posix": "1.4.0",
        "ansible.windows": "1.11.0"
      },
      "known_issues": ["EOL since November 2023"],
      "aap_versions": []
    },
    "2.14": {
      "named_version": "7.x",
      "release_date": "2022-11-07",
      "eol_date": "2024-05-20",
      "control_node_python": ["3.9", "3.10", "3.11"],
      "managed_node_python": ["2.7", "3.5", "3.6", "3.7", "3.8", "3.9", "3.10", "3.11"],
      "major_changes": [
        "Python 3.9+ required for control node",
        "Python 3.11 support added",
        "Further module deprecations"
      ],
      "min_collection_versions": {
        "ansible.posix": "1.5.0",
        "ansible.windows": "1.13.0"
      },
      "known_issues": ["EOL since May 2024"],
      "aap_versions": []
    },
    "2.15": {
      "named_version": "8.x",
      "release_date": "2023-05-15",
      "eol_date": "2024-11-04",
      "control_node_python": ["3.9", "3.10", "3.11"],
      "managed_node_python": ["2.7", "3.5", "3.6", "3.7", "3.8", "3.9", "3.10", "3.11"],
      "major_changes": [
        "Performance improvements",
        "Better collection tooling",
        "Enhanced error reporting"
      ],
      "min_collection_versions": {
        "ansible.posix": "1.5.4",
        "ansible.windows": "1.14.0"
      },
      "known_issues": ["EOL since November 2024"],
      "aap_versions": ["2.4"]
    },
    "2.16": {
      "named_version": "9.x",
      "release_date": "2023-11-06",
      "eol_date": "2025-07-31",
      "control_node_python": ["3.10", "3.11", "3.12"],
      "managed_node_python": ["2.7", "3.6", "3.7", "3.8", "3.9", "3.10", "3.11", "3.12"],
      "major_changes": [
        "Last version supporting Python 2.7 on managed nodes",
        "Target node support expanded to 6 most recent Python versions",
        "Python 3.10+ required for control node"
      ],
      "min_collection_versions": {
        "ansible.posix": "1.6.0",
        "ansible.windows": "2.0.0"
      },
      "known_issues": ["Unmaintained (EOL) - upgrade recommended"],
      "aap_versions": ["2.5", "2.6"]
    },
    "2.17": {
      "named_version": "10.x",
      "release_date": "2024-05-20",
      "eol_date": "2025-11-30",
      "control_node_python": ["3.10", "3.11", "3.12"],
      "managed_node_python": ["3.7", "3.8", "3.9", "3.10", "3.11", "3.12"],
      "major_changes": [
        "Python 2.7 support removed from managed nodes completely",
        "Python 3.7+ required for managed nodes",
        "Continued deprecation cycle enhancements"
      ],
      "min_collection_versions": {
        "ansible.posix": "1.7.0",
        "ansible.windows": "2.1.0"
      },
      "known_issues": ["Unmaintained (EOL) - upgrade recommended"],
      "aap_versions": ["2.5", "2.6"]
    },
    "2.18": {
      "named_version": "11.x",
      "release_date": "2024-11-04",
      "eol_date": "2026-05-31",
      "control_node_python": ["3.11", "3.12", "3.13"],
      "managed_node_python": ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13"],
      "major_changes": [
        "Python 3.11+ required for control node (3.10 no longer supported)",
        "Windows Server 2025 support (OpenSSH enabled)",
        "Enhanced PowerShell integration improvements"
      ],
      "min_collection_versions": {
        "ansible.posix": "1.7.0",
        "ansible.windows": "2.1.0"
      },
      "known_issues": ["Current stable release - EOL May 2026"],
      "aap_versions": ["2.5", "2.6"]
    },
    "2.19": {
      "named_version": "12.x",
      "release_date": "2025-07-21",
      "eol_date": "2026-11-30",
      "control_node_python": ["3.11", "3.12", "3.13"],
      "managed_node_python": ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13"],
      "major_changes": [
        "Significant templating changes for security and performance",
        "Improved error reporting for templating issues",
        "See porting guide for playbook compatibility updates"
      ],
      "min_collection_versions": {
        "ansible.posix": "1.7.0",
        "ansible.windows": "2.1.0"
      },
      "known_issues": ["Security fixes only after Nov 2025 - EOL Nov 2026"],
      "aap_versions": []
    },
    "2.20": {
      "named_version": "13.x",
      "release_date": "2025-11-03",
      "eol_date": "2027-05-31",
      "control_node_python": ["3.12", "3.13", "3.14"],
      "managed_node_python": ["3.9", "3.10", "3.11", "3.12", "3.13", "3.14"],
      "major_changes": [
        "Python 3.12+ required for control node (3.11 no longer supported)",
        "Python 3.14 support added (latest at time of release)",
        "Continued templating engine enhancements"
      ],
      "min_collection_versions": {
        "ansible.posix": "1.7.0",
        "ansible.windows": "2.1.0"
      },
      "known_issues": ["Latest stable release - EOL May 2027"],
      "aap_versions": []
    }
  }
}
