Installation

Install from Package Managers

Tower CLI is available as a package on PyPI.

The preferred way to install is through pip:

$ pip install ansible-tower-cli

Build from Source

ansible-tower-cli may also be consumed and built directly from source.

$ git clone https://github.com/ansible/tower-cli.git

Then, inside tower_cli directory, run

$ make install

and follow the instructions.

If you are not familar with ansible-tower-cli’s dependency tree, we suggested building source in a fresh virtual environment to prevent any dependency conflict.

Install the Right Version

REST API of Ansible Tower is versioned, and each API version is supported by a subset, rather than all, of ansible-tower-cli versions. Make sure you are pairing your Tower backend with a right version of ansible-tower-cli, specifically:

  • If you are using Tower 3.2.0 and beyond, API v2 is available, you should use ansible-tower-cli 3.2.0 and beyond.
  • If you are using a Tower version lower than 3.2.0, only API v1 is available, you should use ansible-tower-cli versions lower than 3.2.0.