Installing PGD CLI
==================

You can install PGD CLI on any system that can connect to the PGD
cluster. To use PGD CLI, you need a user with PGD superuser privileges
or equivalent. The PGD user with superuser privileges is the
 :ref:`bdr_superuser role and replication <bdr_superuser role and replication>`  . An example of an equivalent user is edb_admin on an EDB
BigAnimal distributed high-availability cluster.

Installing automatically with Trusted Postgres Architect (TPA)
--------------------------------------------------------------

By default, Trusted Postgres Architect installs and configures PGD CLI
on each PGD node. If you want to install PGD CLI on any non-PGD instance
in the cluster, attach the pgdcli role to that instance in Trusted
Postgres Architect’s configuration file before deploying. See
 :ref:`Deploying EDB Postgres Distributed using Trusted Postgres Architect <Deploying EDB Postgres Distributed using Trusted Postgres Architect>`  for more information.

Installing manually on Linux
----------------------------

PGD CLI is installable from the EDB repositories. These repositories
require a token to enable downloads from them. Log in to `EDB Repos 2.0 <https://www.enterprisedb.com/repos-downloads>`_ 
to obtain your token. Then execute the command shown for your operating
system, substituting your token for ``<your-token>`` .

Add repository and install PGD CLI on Debian or Ubuntu
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. code:: bash

   curl -1sLf https://downloads.enterprisedb.com/<your-token>/postgres_distributed/setup.deb.sh | sudo -E bash
   sudo apt-get install edb-pgd5-cli

Add repository and install PGD CLI on RHEL, Rocky, AlmaLinux, or Oracle Linux
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. code:: bash

   curl -1sLf https://downloads.enterprisedb.com/<your-token>/postgres_distributed/setup.rpm.sh | sudo -E bash
   sudo yum install edb-pgd5-cli

 :ref:`Next: Using PGD CLI <Using PGD CLI>`