---
title: Konfiguration
description: Die Umgebungsvariablen, die Sie für den Betrieb von Human Plugin setzen – Ihr Zugriffsschlüssel und die Verbindung zu Ihrer PostgreSQL-Datenbank.
canonical: https://developer.unico.io/de/human-plugin/self-hosting/configuration
locale: de
generated_by: markdown-export
---

# Konfiguration

Ihr Zugriffsschlüssel und die Verbindung zu Ihrer Datenbank. Ein fehlender oder ungültiger Wert verhindert den Start.

Human Plugin liest seine Konfiguration einmalig beim Start aus der Umgebung. Eine Änderung erfordert den Neustart des Containers.

## Kurzreferenz

Die minimale `.env` für eine Datenbank, die die unten genannten Standardwerte verwendet:

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

## Zugriffsschlüssel

| Variable | Erforderlich | Hinweise |
| --- | --- | --- |
| `HUMAN_API_ACCESS_KEY` | Ja | Ihr Zugriffsschlüssel. Er verbindet die Installation mit Unico und identifiziert Ihr Konto. Keine Leerzeichen oder Steuerzeichen. Wird nie protokolliert |

Der Zugriffsschlüssel ist ein Geheimnis. Bewahren Sie ihn in Ihrem Secret Store auf und injizieren Sie ihn zur Laufzeit in den Container.

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

## Datenbankverbindung

| Variable | Erforderlich | Standard | Hinweise |
| --- | --- | --- | --- |
| `POSTGRES_ADDRESS_HOST` | Ja | | Hostname oder IP-Adresse Ihres PostgreSQL-Servers |
| `POSTGRES_PASSWORD` | Ja | | Keine Leerzeichen, einfachen Anführungszeichen, Backslashes oder Steuerzeichen. Human Plugin verweigert in diesem Fall den Start, ohne den Wert zu protokollieren |
| `POSTGRES_ADDRESS_PORT` | Nein | `5432` | |
| `POSTGRES_USER` | Nein | `postgres` | Verwenden Sie eine eigene Rolle für Human Plugin |
| `POSTGRES_DATABASE` | Nein | `human_plugin` | Verwenden Sie eine eigene Datenbank für Human Plugin |
| `POSTGRES_SSL_MODE` | Nein | `require` | Verwenden Sie `disable` nur, wenn PostgreSQL auf demselben Host oder als Sidecar läuft |

Die Datenbank darf ausschließlich von Human Plugin genutzt werden. Die Rolle benötigt die Berechtigung, darin Tabellen zu erstellen: Human Plugin erstellt und aktualisiert seine eigenen Tabellen beim Start, bevor es Anfragen annimmt.

Das Passwort ist ein Geheimnis. Bewahren Sie es wie den Zugriffsschlüssel in Ihrem Secret Store auf.

## Alles Weitere

Das Image setzt alle übrigen Werte. Setzen Sie keine weiteren Variablen, es sei denn, Unico fordert Sie dazu auf: Sie gehören nicht zur unterstützten Konfiguration.

## Beispiel

```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` ohne Wert übernimmt die Variable aus Ihrer Shell, sodass die Geheimnisse nicht in der Befehlszeile erscheinen.