> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Comment déployer votre PG Admin

> Apprenez à héberger votre pgadmin pour accéder à votre base de données PostGreSQL depuis n'importe où

## Introduction

* Cet article vous guide dans la création et l'hébergement d'une application PG Admin sur Square Cloud.
* Avant de commencer, assurez-vous d'avoir un compte sur Square Cloud, ce qui peut se faire via la page d'inscription. Vous pouvez utiliser votre e-mail pour créer un compte.
* Enfin, vous devez avoir un plan payant actif sur votre compte. Vous pouvez consulter nos plans et en acheter un selon vos besoins [ici](https://squarecloud.app/fr/pricing).

## Création du projet

* Tout d'abord, nous avons besoin d'un environnement Python. Pour cela, il nous faut un `requirements.txt` ou un `pyproject.toml`.
  Vous pouvez voir comment créer un requirements.txt [ici](https://docs.squarecloud.app/fr/articles/how-to-create-your-requirements).
* Votre `requirements.txt` doit contenir `pgadmin4` ainsi qu'un serveur web pour le servir. Dans ce tutoriel, nous utiliserons `gunicorn`.

```txt requirements.txt theme={null}
pgadmin4
gunicorn
```

* Ensuite, vous aurez besoin d'un fichier de configuration `config_local.py` pour définir certains chemins. Ces chemins détermineront où enregistrer certaines informations sur votre pgadmin.

```py config_local.py theme={null}
SERVER_MODE = True
MAX_LOGIN_ATTEMPTS = 3
"""
    CRITICAL 50
    ERROR    40
    WARNING  30
    SQL      25
    INFO     20
    DEBUG    10
    NOTSET    0
"""
CONSOLE_LOG_LEVEL = 10
DATA_DIR = "/application/.pgadmin/"
LOG_FILE = "/application/.pgadmin/logfile"
SQLITE_PATH = '/application/.pgadmin/pgadmin4.db'
```

<Info>
  Nous avons déjà tout prêt pour le déploiement sur notre dépôt [ici](https://github.com/squarecloud-education/pgadmin4-web/releases). Il vous suffit de télécharger le `project.zip` et de l'uploader.
</Info>

## 📁 Fichiers nécessaires

Les fichiers suivants sont nécessaires dans votre zip :

* requirements.txt ou pyproject.toml
* .env (optionnel)

## ⚙️ Fichier de configuration

* Vous devez configurer l'environnement d'exécution sur `Détecter manuellement` et le définir sur `Python`. Dans un squarecloud.config ou squarecloud.app, cela ressemblera à ceci :

```systemd squarecloud theme={null}
DISPLAY_NAME=App name
RUNTIME=python
MEMORY=1024
START=python -m gunicorn --bind 0.0.0.0:80 --workers=1 --threads=4 pgadmin4.pgAdmin4:app
VERSION=recommended
SUBDOMAIN=my-pgadmin-subdomain
```

* Ensuite, nous devons définir 2 variables d'environnement, `PGADMIN_SETUP_EMAIL` et `PGADMIN_SETUP_PASSWORD`, dans un fichier `.env` ou dans l'environnement Square Cloud sur le menu d'upload.

```systemd .env theme={null}
PGADMIN_SETUP_EMAIL=accessemail@example.com
PGADMIN_SETUP_PASSWORD=yourSecurePassword
```

## Upload du projet sur Square Cloud

Après avoir préparé les fichiers de votre projet, vous pouvez maintenant les uploader sur Square Cloud et héberger votre projet.

<Tabs>
  <Tab title="Upload via le tableau de bord">
    Accédez au [tableau de bord Square Cloud](https://squarecloud.app/fr/dashboard/new) et uploadez les fichiers de votre projet.

    <Frame>
      <img src="https://cdn.squarecloud.app/docs/articles/dashboard/uploading.gif" alt="Téléversement d'une application vers Square Cloud" style={{ borderRadius: "0.2rem" }} />
    </Frame>
  </Tab>

  <Tab title="Upload via la CLI">
    <Steps>
      <Step title="Première étape">
        Tout d'abord, vous devez avoir la CLI installée dans votre environnement. Si vous ne l'avez pas encore, exécutez la commande suivante dans votre terminal :

        ```
        npm install -g @squarecloud/cli
        ```

        Si vous l'avez déjà, nous vous recommandons de la mettre à jour. Pour cela, exécutez la commande suivante dans votre terminal :

        <Tabs>
          <Tab title="Windows">
            ```bash theme={null}
            squarecloud update
            ```
          </Tab>

          <Tab title="Linux, macOS et WSL">
            ```bash theme={null}
            curl -fsSL https://cli.squarecloud.app/install | bash
            ```
          </Tab>
        </Tabs>
      </Step>

      <Step title="Deuxième étape">
        Maintenant, pour vous authentifier et utiliser les autres commandes de la CLI, vous trouverez votre clé d'autorisation [ici](https://squarecloud.app/fr/account/security) en cliquant sur « Request API Key ». Après avoir obtenu votre clé d'autorisation, exécutez la commande suivante :

        ```bash theme={null}
        squarecloud auth login
        ```
      </Step>

      <Step title="Troisième étape">
        Enfin, pour déployer votre application sur Square Cloud à l'aide de la CLI, vous devez exécuter la commande suivante en passant le chemin vers votre fichier zip :

        ```bash theme={null}
        squarecloud upload zip
        ```
      </Step>
    </Steps>
  </Tab>
</Tabs>