blob: f7200416cbdac7b4405f08b8e79278d41485f4e0 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
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
|