Installing Ansible on specific operating systems

Note

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.

The 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.

This document guides you through installing Ansible from different distribution’s package repositories.

To add instructions for another distribution to this guide, package maintainers must do the following:

Ensure the distribution provides a reasonably up-to-date version of ansible.

Ensure that ansible-core and ansible versions are kept in sync to the extent that the build system allows.

Provide a way to contact the distribution maintainers as part of the instructions. Distribution maintainers are also encouraged to join the Ansible Packaging Matrix room.

Installing Ansible on Fedora Linux 

To install the full ansible package run:

$ sudo dnf install ansible

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 ansible-core. 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.

Installing Ansible from EPEL 

Users of CentOS Stream, Almalinux, Rocky Linux, and related distributions can install ansible or Ansible collections from the community maintained EPEL (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.

Installing Ansible on OpenSUSE Tumbleweed/Leap 

$ sudo zypper install ansible

See OpenSUSE Support Portal for additional help with Ansible on OpenSUSE.

Installing Ansible on Ubuntu 

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

Note

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 -u or --update flag. Adjust your script as needed.

File any issues in the PPA’s issue tracker.

Installing Ansible on Debian 

While Ansible is available from the main Debian repository, it can be out of date.

To get a more recent version, Debian users can use the Ubuntu PPA according to the following table:

Debian		Ubuntu	UBUNTU_CODENAME
Debian 12 (Bookworm)	->	Ubuntu 22.04 (Jammy)	`jammy`
Debian 11 (Bullseye)	->	Ubuntu 20.04 (Focal)	`focal`
Debian 10 (Buster)	->	Ubuntu 18.04 (Bionic)	`bionic`

In the following example, we assume that you have wget and gpg already installed (sudo apt install wget gpg).

Run the following commands to add the repository and install Ansible. Set UBUNTU_CODENAME=... based on the table above (we use jammy in this example).

$ UBUNTU_CODENAME=jammy
$ wget -O- "https://keyserver.ubuntu.com/pks/lookup?fingerprint=on&op=get&search=0x6125E2A8C77F2818FB7BD15B93C4A3FD7BB9C367" | sudo gpg --dearmour -o /usr/share/keyrings/ansible-archive-keyring.gpg
$ echo "deb [signed-by=/usr/share/keyrings/ansible-archive-keyring.gpg] http://ppa.launchpad.net/ansible/ansible/ubuntu $UBUNTU_CODENAME main" | sudo tee /etc/apt/sources.list.d/ansible.list
$ sudo apt update && sudo apt install ansible

Note: the ” ” around the keyserver URL are important. Around the “echo deb” it is important to use ” ” rather than ‘ ‘.

These commands download the signing key and add an entry to apt’s sources pointing to the PPA.

Previously, you may have used apt-key add. This is now deprecated for security reasons (on Debian, Ubuntu, and elsewhere). For more details, see this AskUbuntu post. Also note that, for security reasons, we do NOT add the key to /etc/apt/trusted.gpg.d/ nor to /etc/apt/trusted.gpg where it would be allowed to sign releases from ANY repository.

Installing Ansible on Arch Linux 

To install the full ansible package run:

$ sudo pacman -S ansible

To install the minimal ansible-core package run:

$ sudo pacman -S ansible-core

Several Ansible ecosystem packages are also available from the Arch Linux repositories as standalone packages that users can install alongside ansible-core. See the Arch Linux Packages index for a full list of Ansible packages in Arch Linux.

Please open an issue in the related package GitLab repository to reach the package maintainers.

Installing Ansible on Windows 

You cannot use a Windows system for the Ansible control node. See Can Ansible run on Windows?

Installing Ansible on specific operating systems

Installing Ansible on Fedora Linux

Installing Ansible from EPEL

Installing Ansible on OpenSUSE Tumbleweed/Leap

Installing Ansible on Ubuntu

Installing Ansible on Debian

Installing Ansible on Arch Linux

Installing Ansible on Windows