Skip to content

Installation Section needs info added to make sure you get the latest version. Like you need pip and python x to get the latest binaries #3259

@dwaynebullock

Description

@dwaynebullock

Summary

After filing a bug report to see why the install is not installing the latest version. It was pointed out you need pip and python version X to get the latest versions. No where in the install doc does it say in order to get the latest v 2.19 you need to make sure you have Python 3.11 - 3.13. It just references the support matrix. Please update the docs to say if a certain version is needed to be at the latest you need Python 3.11 - 3.13 and you need pip to match.

So my point is to approach this as a new user with no triable knowledge about knowing you need this version of this to get that. This is the install guide where new users are using to install from, its the install guide where you need to tell them those things. It needs to say if you want the latest or even supported versions you need to make sure you do this. Like how it doesn't mention that ubuntu will install the latest python and things needed but the redhat distro's dont. Like assuming you are using ubuntu and the generic pip commands will get you the latest but on redhat whatever you need to use to python 3.x to get ansible version X..

For example following default install procedures on redhat install 2.15 which is Unmaintained (end of life). But on Ubuntu you get 2.19..

https://docs.ansible.com/projects/ansible/latest/installation_guide/intro_installation.html#pipx-install

Issue Type

Documentation Report

Component Name

https://docs.ansible.com/projects/ansible/latest/installation_guide/intro_installation.html#installing-and-upgrading-ansible-with-pipx

Ansible Version

$ ansible --version

Configuration

# if using a version older than ansible-core 2.12 you should omit the '-t all'
$ ansible-config dump --only-changed -t all

OS / Environment

Ubtunu, Redhat,Alma

Additional Information

Add notes/details that if you want the latest ansible code you need Python 3.11 - 3.13 somewhere in the install doc. Or mention that some distro's might install older version by using these commands. It does mention the the support matrix at the very top. But down in the install section it doesn't say in order to be on the latest version and be supported to make sure you have the latest version of not just the default steps listed here. Again look at this as a new user and if you need phython-3.12 say it. not just python.

Like at the top of the page it says..
For your control node (the machine that runs Ansible), you can use nearly any UNIX-like machine with Python installed.

But doesn't mention that if you are using older versions expect to get older ansible packages. Like how it doesn't mention that the target needs to have a certain version to run. Like if 2.19 control node needs python v3.12 but the client/target can be an older version without issues.

Code of Conduct

  • I agree to follow the Ansible Code of Conduct

Metadata

Metadata

Assignees

No one assigned

    Labels

    needs_triageNeeds a first human triage before being processed.new_contributorThis PR is the first contribution by a new community member.

    Type

    No type

    Projects

    Status

    🆕 Triage

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions