---
title: Configuración
description: 'Las variables de entorno que defines para ejecutar Human Plugin: tu clave de acceso y la conexión con tu base de datos PostgreSQL.'
canonical: https://developer.unico.io/es/human-plugin/self-hosting/configuration
locale: es
generated_by: markdown-export
---

# Configuración

Tu clave de acceso y la conexión con tu base de datos. Un valor ausente o no válido detiene el arranque.

Human Plugin lee su configuración del entorno una sola vez, al arrancar. Cambiar un valor requiere reiniciar el contenedor.

## Referencia rápida

El `.env` mínimo para una base de datos que usa los valores predeterminados de abajo:

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

## Clave de acceso

| Variable | Obligatoria | Notas |
| --- | --- | --- |
| `HUMAN_API_ACCESS_KEY` | Sí | Tu clave de acceso. Conecta la instalación con Unico e identifica tu cuenta. Sin espacios en blanco ni caracteres de control. Nunca se registra en los logs |

La clave de acceso es un secreto. Guárdala en tu almacén de secretos e inyéctala en el contenedor en tiempo de ejecución.

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

## Conexión con la base de datos

| Variable | Obligatoria | Valor predeterminado | Notas |
| --- | --- | --- | --- |
| `POSTGRES_ADDRESS_HOST` | Sí | | Nombre de host o dirección IP de tu servidor PostgreSQL |
| `POSTGRES_PASSWORD` | Sí | | Sin espacios en blanco, comillas simples, barras invertidas ni caracteres de control. Human Plugin se niega a arrancar si el valor contiene alguno, sin registrar el valor |
| `POSTGRES_ADDRESS_PORT` | No | `5432` | |
| `POSTGRES_USER` | No | `postgres` | Usa un rol dedicado a Human Plugin |
| `POSTGRES_DATABASE` | No | `human_plugin` | Usa una base de datos dedicada a Human Plugin |
| `POSTGRES_SSL_MODE` | No | `require` | Usa `disable` solo cuando PostgreSQL se ejecuta en el mismo host o como sidecar |

La base de datos debe ser usada únicamente por Human Plugin. El rol necesita permiso para crear tablas en ella: Human Plugin crea y actualiza sus propias tablas al arrancar, antes de aceptar solicitudes.

La contraseña es un secreto. Guárdala en tu almacén de secretos, igual que la clave de acceso.

## Todo lo demás

La imagen define todos los demás valores. No definas otras variables a menos que Unico te lo pida: no forman parte de la configuración soportada.

## Ejemplo

```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` sin valor pasa la variable desde tu shell, de modo que los secretos no aparecen en la línea de comandos.