diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-28 16:04:21 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-28 16:04:21 +0000 |
commit | 8a754e0858d922e955e71b253c139e071ecec432 (patch) | |
tree | 527d16e74bfd1840c85efd675fdecad056c54107 /docs/docsite/rst/installation_guide/installation_distros.rst | |
parent | Initial commit. (diff) | |
download | ansible-core-upstream.tar.xz ansible-core-upstream.zip |
Adding upstream version 2.14.3.upstream/2.14.3upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'docs/docsite/rst/installation_guide/installation_distros.rst')
-rw-r--r-- | docs/docsite/rst/installation_guide/installation_distros.rst | 110 |
1 files changed, 110 insertions, 0 deletions
diff --git a/docs/docsite/rst/installation_guide/installation_distros.rst b/docs/docsite/rst/installation_guide/installation_distros.rst new file mode 100644 index 0000000..f720041 --- /dev/null +++ b/docs/docsite/rst/installation_guide/installation_distros.rst @@ -0,0 +1,110 @@ +.. _installing_distros: + +Installing Ansible on specific operating systems +================================================ + +The ``ansible`` package can always be :ref:`installed from PyPI using pip <intro_installation_guide>` 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. + +.. contents:: + :local: + +Installing Ansible on Fedora or CentOS +-------------------------------------- + +On Fedora: + +.. code-block:: bash + + $ sudo dnf install ansible + +On CentOS: + +.. code-block:: bash + + $ sudo yum install epel-release + $ sudo yum install ansible + +RPMs for currently supported versions of CentOS are also available from `EPEL <https://fedoraproject.org/wiki/EPEL>`_. + + +.. _from_apt: + +Installing Ansible on Ubuntu +---------------------------- + +Ubuntu builds are available `in a PPA here <https://launchpad.net/~ansible/+archive/ubuntu/ansible>`_. + +To configure the PPA on your system and install Ansible run these commands: + +.. code-block:: bash + + $ 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. + + + + +Installing Ansible on Debian +---------------------------- + +Debian users can use the same source as the Ubuntu PPA (using the following table). + +.. list-table:: + :header-rows: 1 + + * - Debian + - + - Ubuntu + * - Debian 11 (Bullseye) + - -> + - Ubuntu 20.04 (Focal) + * - Debian 10 (Buster) + - -> + - Ubuntu 18.04 (Bionic) + + +.. note:: + + Ansible releases are only built for Ubuntu 18.04 (Bionic) or later releases. + +Add the following line to ``/etc/apt/sources.list`` or ``/etc/apt/sources.list.d/ansible.list``: + +.. code-block:: bash + + deb http://ppa.launchpad.net/ansible/ansible/ubuntu MATCHING_UBUNTU_CODENAME_HERE main + +Example for Debian 11 (Bullseye) + +.. code-block:: bash + + deb http://ppa.launchpad.net/ansible/ansible/ubuntu focal main + +Then run these commands: + +.. code-block:: bash + + $ sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 93C4A3FD7BB9C367 + $ sudo apt update + $ sudo apt install ansible + + + +.. _from_windows: + +Installing Ansible on Windows +------------------------------ + +You cannot use a Windows system for the Ansible control node. See :ref:`windows_faq_ansible` + +.. seealso:: + + `Installing Ansible on Arch Linux <https://wiki.archlinux.org/title/Ansible#Installation>`_ + Distro-specific installation on Arch Linux + `Installing Ansible on Clear Linux <https://clearlinux.org/software/bundle/ansible>`_ + Distro-specific installation on Clear Linux |