---
title: Configuration
description: 'Les variables d''environnement à définir pour exécuter Human Plugin : votre clé d''accès et la connexion à votre base de données PostgreSQL.'
canonical: https://developer.unico.io/fr/human-plugin/self-hosting/configuration
locale: fr
generated_by: markdown-export
---

# Configuration

Votre clé d'accès et la connexion à votre base de données. Une valeur manquante ou invalide empêche le démarrage.

Human Plugin lit sa configuration dans l'environnement une seule fois, au démarrage. Modifier une valeur nécessite de redémarrer le conteneur.

## Référence rapide

Le fichier `.env` minimal pour une base de données qui utilise les valeurs par défaut ci-dessous :

```bash title=".env"
HUMAN_API_ACCESS_KEY=<your access key>
POSTGRES_ADDRESS_HOST=<database host>
POSTGRES_PASSWORD=<database password>
```

## Clé d'accès

| Variable | Obligatoire | Remarques |
| --- | --- | --- |
| `HUMAN_API_ACCESS_KEY` | Oui | Votre clé d'accès. Elle relie l'installation à Unico et identifie votre compte. Sans espace ni caractère de contrôle. Jamais journalisée |

La clé d'accès est un secret. Conservez-la dans votre gestionnaire de secrets et injectez-la dans le conteneur à l'exécution.

<a id="database-connection"></a>

## Connexion à la base de données

| Variable | Obligatoire | Valeur par défaut | Remarques |
| --- | --- | --- | --- |
| `POSTGRES_ADDRESS_HOST` | Oui | | Nom d'hôte ou adresse IP de votre serveur PostgreSQL |
| `POSTGRES_PASSWORD` | Oui | | Sans espace, apostrophe, barre oblique inverse ni caractère de contrôle. Human Plugin refuse de démarrer si l'un d'eux est présent, sans journaliser la valeur |
| `POSTGRES_ADDRESS_PORT` | Non | `5432` | |
| `POSTGRES_USER` | Non | `postgres` | Utilisez un rôle dédié à Human Plugin |
| `POSTGRES_DATABASE` | Non | `human_plugin` | Utilisez une base de données dédiée à Human Plugin |
| `POSTGRES_SSL_MODE` | Non | `require` | N'utilisez `disable` que lorsque PostgreSQL s'exécute sur le même hôte ou en conteneur sidecar |

La base de données doit être utilisée uniquement par Human Plugin. Le rôle doit avoir le droit d'y créer des tables : Human Plugin crée et met à jour ses propres tables au démarrage, avant d'accepter des requêtes.

Le mot de passe est un secret. Conservez-le dans votre gestionnaire de secrets, comme la clé d'accès.

## Tout le reste

L'image définit toutes les autres valeurs. Ne définissez pas d'autres variables, sauf si Unico vous le demande : elles ne font pas partie de la configuration prise en charge.

## Exemple

```bash
docker run -d --name human-plugin --stop-timeout 60 -p 127.0.0.1:8080:8080 \
  -e HUMAN_API_ACCESS_KEY \
  -e POSTGRES_ADDRESS_HOST=db.internal \
  -e POSTGRES_USER=human_plugin \
  -e POSTGRES_PASSWORD \
  pkg.unico.run/human-plugin-api:latest
```

`-e NAME` sans valeur transmet la variable depuis votre shell, de sorte que les secrets n'apparaissent pas dans la ligne de commande.