---
title: Human Plugin in Ihrer Infrastruktur betreiben
description: Was der Betrieb von Human Plugin umfasst – ein Container und Ihre PostgreSQL-Datenbank – und die Reihenfolge einer Bereitstellung.
canonical: https://developer.unico.io/de/human-plugin/self-hosting/overview
locale: de
generated_by: markdown-export
---

# Human Plugin in Ihrer Infrastruktur betreiben

Ein Container und eine PostgreSQL-Datenbank in Ihrem Netzwerk, und Sie sind mit Unico verbunden.

```mermaid
flowchart LR
  A[Your back-end] --> B[Human Plugin container]
  B --> C[(Your PostgreSQL, dedicated)]
```

## Voraussetzungen

| Voraussetzung | Detail |
| --- | --- |
| Container-Laufzeit | Docker, Docker Compose oder Kubernetes. Das Image wird für `linux/amd64` und `linux/arm64` gebaut und läuft als Nicht-Root |
| PostgreSQL | Version 16 oder höher. Eine Datenbank, die nur von Human Plugin verwendet wird und mit Benutzer und Passwort erreichbar ist. SSL ist standardmäßig erforderlich |
| Ausgehendes HTTPS | Zu Unico. Siehe [Netzwerk und Sicherheit](/de/human-plugin/self-hosting/networking-and-security) |
| Eingehend | Port `8080`, reines HTTP, nur von Ihrem Back-end |
| Secrets | Ihr Zugriffsschlüssel und das Datenbankpasswort |

<a id="hardware-requirements"></a>

## Hardware-Anforderungen

Das Minimum, um Human Plugin mit bis zu **1.500 Transaktionen pro Minute** zu betreiben, mit Selfies von bis zu 800 KB.

### Human Plugin

| Ressource | Minimum |
| --- | --- |
| CPU | 1 vCPU pro Replikat |
| Arbeitsspeicher | 1 GB pro Replikat |

Für mehr Volumen fügen Sie pro 1.500 Transaktionen pro Minute ein Replikat hinzu. Wir empfehlen außerdem, mehr als ein Replikat zu betreiben, damit Human Plugin verfügbar bleibt, während eines neu startet.

### PostgreSQL

| Ressource | Minimum |
| --- | --- |
| Version | 16 |
| CPU | 2 vCPU |
| Arbeitsspeicher | 4 GB |
| Festplatte | SSD |

Zur Abschätzung des Speicherplatzes rechnen Sie etwa 1,7 KB pro Prozess × Prozesse pro Tag × die Tage, die Sie aufbewahren, plus 30 %.

### Netzwerk

Ausgehendes HTTPS (Port 443) zu Unico. Siehe [Netzwerk und Sicherheit](/de/human-plugin/self-hosting/networking-and-security).

## Das Image

Human Plugin wird als `pkg.unico.run/human-plugin-api:latest` veröffentlicht. Betreiben Sie immer das Tag `latest`, das dem aktuellen Release entspricht. Rufen Sie es mit den Registry-Zugangsdaten (Benutzername und Token) ab, die Unico Ihnen gibt. Siehe [Voraussetzungen und Zugang](/de/human-plugin/get-started/prerequisites).

## Reihenfolge der Bereitstellung

1. Erstellen Sie die dedizierte Datenbank und eine Rolle für Human Plugin.
2. Legen Sie die [Konfiguration](/de/human-plugin/self-hosting/configuration) fest, mit den Secrets aus Ihrem Secret Store.
3. Starten Sie den Container mit [Docker Compose](/de/human-plugin/self-hosting/docker-compose) oder [Kubernetes](/de/human-plugin/self-hosting/kubernetes), mit einem Stopp-Timeout von mindestens 60 Sekunden.
4. Warten Sie, bis `GET /health/ready` mit `200` antwortet, bevor Sie Datenverkehr weiterleiten. Siehe [Health und Monitoring](/de/human-plugin/self-hosting/health-and-monitoring).
5. Beschränken Sie den Zugriff auf Ihr Back-end. Siehe [Netzwerk und Sicherheit](/de/human-plugin/self-hosting/networking-and-security).
6. Führen Sie die Create-Anfrage aus dem [Quickstart](/de/human-plugin/get-started/quickstart#3-create-a-process) dagegen aus.

## Was beim Start passiert

Human Plugin lädt den [Attributkatalog](/de/human-plugin/additional-resources/attribute-catalog) herunter, verbindet sich mit PostgreSQL und bereitet seine Tabellen vor und öffnet dann den Port. Es bricht mit einem Fehler ab, bevor es lauscht, wenn:

- eine erforderliche Einstellung fehlt oder ungültig ist;
- der Attributkatalog nicht heruntergeladen werden kann;
- PostgreSQL nicht erreichbar ist oder die Rolle keine Tabellen erstellen kann.

Das Protokoll nennt den Grund. Siehe [Fehlerbehebung](/de/human-plugin/additional-resources/troubleshooting).

## Mehrere Instanzen

Human Plugin hält keinen Anfragezustand im Arbeitsspeicher, daher können mehrere Container eine Datenbank teilen. Container, die gleichzeitig starten, koordinieren sich über die Datenbank, sodass Sie Replikate gemeinsam ausrollen können.

## Weg in die Produktion

- Halten Sie das Stopp-Timeout bei 60 Sekunden oder mehr.
- Leiten Sie Datenverkehr erst an einen Container, wenn `/health/ready` mit `200` antwortet.
- Machen Sie Human Plugin niemals außerhalb Ihres privaten Netzwerks zugänglich.
- Sichern Sie die Datenbank: Sie enthält Ihre Intelligence. Siehe [Betrieb](/de/human-plugin/self-hosting/operations).