Installing Ansible on specific operating systems
These instructions are provided by their respective communities. Any bugs/issues should be filed with that community to update these instructions. Ansible maintains only the
pip install instructions.
ansible package can always be installed from PyPI using pip on most systems but it is also packaged and maintained by the community for a variety of Linux distributions.
The following instructions will guide you through installing the
ansible package with your preferred distribution’s package manager.
For maintainers who wish to add distributions to this guide, installation instructions are included here only for distributions with a reasonably up-to-date version of
ansible. The distribution MUST ensure that
ansible versions are kept in sync to the extent that the distribution build system allows. Maintainers MUST include a way to contact them with their instructions here and are encouraged to join the Ansible Packaging Matrix room.
To install the batteries included
ansible package on Fedora run
$ sudo dnf install ansible
If you prefer to install the minimal
ansible-core package run
$ sudo dnf install ansible-core
Several Ansible collections are also available from the Fedora repositories as
standalone packages that users can install alongside
For example, to install the
community.general collection run
$ sudo dnf install ansible-collection-community-general
See the Fedora Packages index for a full list of Ansible collections packaged in Fedora.
Please file a bug against the
Fedora product in Red Hat Bugzilla to reach the package maintainers.
Users of CentOS Stream, Almalinux, Rocky Linux, and related distributions
ansible or Ansible collections from the community maintained
(Extra Packages for Enterprise Linux) repository.
After enabling the EPEL repository,
users can use the same
dnf commands as for Fedora Linux.
Please file a bug against the
Fedora EPEL product in Red Hat Bugzilla to reach the package maintainers.
$ sudo zypper install ansible
See OpenSUSE Support Portal <https://en.opensuse.org/Portal:Support> for additional help with Ansible on OpenSUSE.
Ubuntu builds are available in a PPA here.
To configure the PPA on your system and install Ansible run these commands:
$ sudo apt update $ sudo apt install software-properties-common $ sudo add-apt-repository --yes --update ppa:ansible/ansible $ sudo apt install ansible
On older Ubuntu distributions, “software-properties-common” is called “python-software-properties”. You may want to use
apt-get rather than
apt in older versions. Also, be aware that only newer distributions (that is, 18.04, 18.10, and later) have a
--update flag. Adjust your script as needed.
Debian users can use the same source as the Ubuntu PPA (using the following table).
Debian 11 (Bullseye)
Ubuntu 20.04 (Focal)
Debian 10 (Buster)
Ubuntu 18.04 (Bionic)
Ansible releases are only built for Ubuntu 18.04 (Bionic) or later releases.
Add the following line to
deb http://ppa.launchpad.net/ansible/ansible/ubuntu MATCHING_UBUNTU_CODENAME_HERE main
Example for Debian 11 (Bullseye)
deb http://ppa.launchpad.net/ansible/ansible/ubuntu focal main
Then run these commands:
$ sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 93C4A3FD7BB9C367 $ sudo apt update $ sudo apt install ansible
You cannot use a Windows system for the Ansible control node. See Can Ansible run on Windows?