---
title: Konfigurasi
description: Variabel lingkungan yang Anda atur untuk menjalankan Human Plugin — access key Anda dan koneksi ke database PostgreSQL Anda.
canonical: https://developer.unico.io/id/human-plugin/self-hosting/configuration
locale: id
generated_by: markdown-export
---

# Konfigurasi

Access key Anda dan koneksi ke database Anda. Nilai yang hilang atau tidak valid menghentikan proses startup.

Human Plugin membaca konfigurasinya dari environment satu kali, saat startup. Mengubah nilai memerlukan restart container.

## Referensi cepat

`.env` minimum untuk database yang menggunakan nilai default di bawah:

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

## Access key

| Variabel | Wajib | Catatan |
| --- | --- | --- |
| `HUMAN_API_ACCESS_KEY` | Ya | Access key Anda. Menghubungkan instalasi ke Unico dan mengidentifikasi akun Anda. Tanpa spasi atau karakter kontrol. Tidak pernah dicatat di log |

Access key adalah rahasia. Simpan di secret store Anda dan injeksikan ke container saat runtime.

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

## Koneksi database

| Variabel | Wajib | Default | Catatan |
| --- | --- | --- | --- |
| `POSTGRES_ADDRESS_HOST` | Ya | | Nama host atau alamat IP server PostgreSQL Anda |
| `POSTGRES_PASSWORD` | Ya | | Tanpa spasi, tanda kutip tunggal, backslash, atau karakter kontrol. Human Plugin menolak untuk start jika ada, tanpa mencatat nilainya di log |
| `POSTGRES_ADDRESS_PORT` | Tidak | `5432` | |
| `POSTGRES_USER` | Tidak | `postgres` | Gunakan role khusus untuk Human Plugin |
| `POSTGRES_DATABASE` | Tidak | `human_plugin` | Gunakan database khusus untuk Human Plugin |
| `POSTGRES_SSL_MODE` | Tidak | `require` | Gunakan `disable` hanya jika PostgreSQL berjalan di host yang sama atau sebagai sidecar |

Database harus digunakan hanya oleh Human Plugin. Role memerlukan izin untuk membuat tabel di dalamnya: Human Plugin membuat dan memperbarui tabelnya sendiri saat startup, sebelum menerima permintaan.

Password adalah rahasia. Simpan di secret store Anda, seperti access key.

## Pengaturan lainnya

Image menetapkan semua nilai lainnya. Jangan mengatur variabel lain kecuali Unico memintanya: variabel tersebut bukan bagian dari konfigurasi yang didukung.

## Contoh

```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` tanpa nilai meneruskan variabel dari shell Anda, sehingga rahasia tidak muncul di command line.