---
title: Ejecuta Human Plugin en tu infraestructura
description: Qué implica ejecutar Human Plugin (un contenedor y tu base de datos PostgreSQL) y el orden de un despliegue.
canonical: https://developer.unico.io/es/human-plugin/self-hosting/overview
locale: es
generated_by: markdown-export
---

# Ejecuta Human Plugin en tu infraestructura

Un contenedor y una base de datos PostgreSQL en tu red, y ya estás conectado a Unico.

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

## Requisitos

| Requisito | Detalle |
| --- | --- |
| Runtime de contenedores | Docker, Docker Compose o Kubernetes. La imagen se construye para `linux/amd64` y `linux/arm64` y se ejecuta sin privilegios de root |
| PostgreSQL | Versión 16 o posterior. Una base de datos usada solo por Human Plugin, accesible con usuario y contraseña. SSL es obligatorio por defecto |
| HTTPS de salida | Hacia Unico. Consulta [Red y seguridad](/es/human-plugin/self-hosting/networking-and-security) |
| Entrada | Puerto `8080`, HTTP plano, solo desde tu back-end |
| Secretos | Tu clave de acceso y la contraseña de la base de datos |

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

## Requisitos de hardware

El mínimo para ejecutar Human Plugin con hasta **1.500 transacciones por minuto**, con selfies de hasta 800 KB.

### Human Plugin

| Recurso | Mínimo |
| --- | --- |
| CPU | 1 vCPU por réplica |
| Memoria | 1 GB por réplica |

Para más volumen, añade una réplica por cada 1.500 transacciones por minuto. También sugerimos ejecutar más de una réplica, para que Human Plugin siga disponible mientras una se reinicia.

### PostgreSQL

| Recurso | Mínimo |
| --- | --- |
| Versión | 16 |
| CPU | 2 vCPU |
| Memoria | 4 GB |
| Disco | SSD |

Para estimar el espacio en disco, calcula unos 1,7 KB por proceso × procesos por día × los días que conserves, más un 30 %.

### Red

HTTPS de salida (puerto 443) hacia Unico. Consulta [Red y seguridad](/es/human-plugin/self-hosting/networking-and-security).

## La imagen

Human Plugin se publica como `pkg.unico.run/human-plugin-api:latest`. Ejecuta siempre la etiqueta `latest`, que es la versión actual. Descárgala con las credenciales del registry (usuario y token) que te entrega Unico. Consulta [Requisitos previos y acceso](/es/human-plugin/get-started/prerequisites).

## Orden del despliegue

1. Crea la base de datos dedicada y un rol para Human Plugin.
2. Define la [configuración](/es/human-plugin/self-hosting/configuration), con los secretos de tu almacén de secretos.
3. Inicia el contenedor con [Docker Compose](/es/human-plugin/self-hosting/docker-compose) o [Kubernetes](/es/human-plugin/self-hosting/kubernetes), con un tiempo de espera de parada de al menos 60 segundos.
4. Espera a que `GET /health/ready` responda `200` antes de enrutar tráfico. Consulta [Salud y monitoreo](/es/human-plugin/self-hosting/health-and-monitoring).
5. Restringe el acceso a tu back-end. Consulta [Red y seguridad](/es/human-plugin/self-hosting/networking-and-security).
6. Ejecuta contra él la solicitud de creación del [Quickstart](/es/human-plugin/get-started/quickstart#3-create-a-process).

## Qué ocurre al iniciar

Human Plugin descarga el [catálogo de atributos](/es/human-plugin/additional-resources/attribute-catalog), se conecta a PostgreSQL y prepara sus tablas, y luego abre el puerto. Se detiene con un error, antes de escuchar, cuando:

- falta una configuración obligatoria o no es válida;
- no se puede descargar el catálogo de atributos;
- PostgreSQL no es accesible, o el rol no puede crear tablas.

El log indica el motivo. Consulta [Solución de problemas](/es/human-plugin/additional-resources/troubleshooting).

## Varias instancias

Human Plugin no guarda estado de solicitudes en memoria, por lo que varios contenedores pueden compartir una misma base de datos. Los contenedores que inician al mismo tiempo se coordinan a través de la base de datos, así que puedes desplegar réplicas de forma conjunta.

## Antes de pasar a producción

- Mantén el tiempo de espera de parada en 60 segundos o más.
- Enruta tráfico a un contenedor solo después de que `/health/ready` responda `200`.
- Nunca expongas Human Plugin fuera de tu red privada.
- Respalda la base de datos: contiene tu inteligencia. Consulta [Operación](/es/human-plugin/self-hosting/operations).