---
title: Jalankan Human Plugin di infrastruktur Anda
description: Apa yang dibutuhkan untuk menjalankan Human Plugin (satu container dan database PostgreSQL Anda) serta urutan deployment.
canonical: https://developer.unico.io/id/human-plugin/self-hosting/overview
locale: id
generated_by: markdown-export
---

# Jalankan Human Plugin di infrastruktur Anda

Satu container dan satu database PostgreSQL di jaringan Anda, dan Anda sudah terhubung ke Unico.

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

## Persyaratan

| Persyaratan | Detail |
| --- | --- |
| Container runtime | Docker, Docker Compose, atau Kubernetes. Image dibangun untuk `linux/amd64` dan `linux/arm64` dan berjalan sebagai non-root |
| PostgreSQL | Versi 16 atau lebih baru. Database yang hanya digunakan oleh Human Plugin, dapat diakses dengan user dan kata sandi. SSL diwajibkan secara default |
| HTTPS keluar | Ke Unico. Lihat [Jaringan dan keamanan](/id/human-plugin/self-hosting/networking-and-security) |
| Masuk | Port `8080`, HTTP biasa, hanya dari back-end Anda |
| Secret | Access key Anda dan kata sandi database |

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

## Persyaratan perangkat keras

Minimum untuk menjalankan Human Plugin hingga **1.500 transaksi per menit**, dengan selfie berukuran hingga 800 KB.

### Human Plugin

| Sumber daya | Minimum |
| --- | --- |
| CPU | 1 vCPU per replika |
| Memori | 1 GB per replika |

Untuk volume yang lebih besar, tambahkan satu replika untuk setiap 1.500 transaksi per menit. Kami juga menyarankan menjalankan lebih dari satu replika, agar Human Plugin tetap tersedia saat salah satunya di-restart.

### PostgreSQL

| Sumber daya | Minimum |
| --- | --- |
| Versi | 16 |
| CPU | 2 vCPU |
| Memori | 4 GB |
| Disk | SSD |

Untuk memperkirakan ruang disk, hitung sekitar 1,7 KB per proses × proses per hari × jumlah hari penyimpanan, ditambah 30%.

### Jaringan

HTTPS keluar (port 443) ke Unico. Lihat [Jaringan dan keamanan](/id/human-plugin/self-hosting/networking-and-security).

## Image

Human Plugin dipublikasikan sebagai `pkg.unico.run/human-plugin-api:latest`. Selalu jalankan tag `latest`, yaitu rilis saat ini. Unduh dengan kredensial registry (username dan token) yang diberikan Unico kepada Anda. Lihat [Prasyarat dan akses](/id/human-plugin/get-started/prerequisites).

## Urutan deployment

1. Buat database khusus dan sebuah role untuk Human Plugin.
2. Atur [konfigurasi](/id/human-plugin/self-hosting/configuration), dengan secret dari secret store Anda.
3. Jalankan container dengan [Docker Compose](/id/human-plugin/self-hosting/docker-compose) atau [Kubernetes](/id/human-plugin/self-hosting/kubernetes), dengan stop timeout minimal 60 detik.
4. Tunggu hingga `GET /health/ready` menjawab `200` sebelum mengalirkan traffic. Lihat [Kesehatan dan pemantauan](/id/human-plugin/self-hosting/health-and-monitoring).
5. Batasi akses hanya untuk back-end Anda. Lihat [Jaringan dan keamanan](/id/human-plugin/self-hosting/networking-and-security).
6. Jalankan permintaan create dari [Quickstart](/id/human-plugin/get-started/quickstart#3-create-a-process) terhadapnya.

## Apa yang terjadi saat startup

Human Plugin mengunduh [katalog atribut](/id/human-plugin/additional-resources/attribute-catalog), terhubung ke PostgreSQL dan menyiapkan tabelnya, lalu membuka port. Ia berhenti dengan error, sebelum mulai mendengarkan, ketika:

- pengaturan yang wajib tidak ada atau tidak valid;
- katalog atribut tidak dapat diunduh;
- PostgreSQL tidak dapat dijangkau, atau role tidak dapat membuat tabel.

Log menyebutkan alasannya. Lihat [Pemecahan masalah](/id/human-plugin/additional-resources/troubleshooting).

## Beberapa instance

Human Plugin tidak menyimpan state permintaan di memori, sehingga beberapa container dapat berbagi satu database. Container yang dimulai bersamaan berkoordinasi melalui database, sehingga Anda dapat meluncurkan replika sekaligus.

## Menuju produksi

- Pertahankan stop timeout 60 detik atau lebih.
- Alirkan traffic ke container hanya setelah `/health/ready` menjawab `200`.
- Jangan pernah mengekspos Human Plugin di luar jaringan privat Anda.
- Lakukan backup database: ia menyimpan intelligence Anda. Lihat [Operasional](/id/human-plugin/self-hosting/operations).