---
title: Configuração
description: As variáveis de ambiente que você define para executar o Human Plugin — sua chave de acesso e a conexão com seu banco de dados PostgreSQL.
canonical: https://developer.unico.io/pt-BR/human-plugin/self-hosting/configuration
locale: pt-BR
generated_by: markdown-export
---

# Configuração

Sua chave de acesso e a conexão com seu banco de dados. Um valor ausente ou inválido impede a inicialização.

O Human Plugin lê sua configuração do ambiente uma única vez, na inicialização. Alterar um valor exige reiniciar o container.

## Referência rápida

O `.env` mínimo para um banco de dados que usa os valores padrão abaixo:

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

## Chave de acesso

| Variável | Obrigatória | Observações |
| --- | --- | --- |
| `HUMAN_API_ACCESS_KEY` | Sim | Sua chave de acesso. Ela conecta a instalação à Unico e identifica sua conta. Sem espaços em branco nem caracteres de controle. Nunca é registrada em log |

A chave de acesso é um segredo. Mantenha-a no seu cofre de segredos e injete-a no container em tempo de execução.

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

## Conexão com o banco de dados

| Variável | Obrigatória | Padrão | Observações |
| --- | --- | --- | --- |
| `POSTGRES_ADDRESS_HOST` | Sim | | Nome do host ou endereço IP do seu servidor PostgreSQL |
| `POSTGRES_PASSWORD` | Sim | | Sem espaços em branco, aspas simples, barras invertidas nem caracteres de controle. O Human Plugin se recusa a iniciar se houver algum, sem registrar o valor em log |
| `POSTGRES_ADDRESS_PORT` | Não | `5432` | |
| `POSTGRES_USER` | Não | `postgres` | Use um role dedicado ao Human Plugin |
| `POSTGRES_DATABASE` | Não | `human_plugin` | Use um banco de dados dedicado ao Human Plugin |
| `POSTGRES_SSL_MODE` | Não | `require` | Use `disable` somente quando o PostgreSQL rodar no mesmo host ou como sidecar |

O banco de dados deve ser usado exclusivamente pelo Human Plugin. O role precisa de permissão para criar tabelas nele: o Human Plugin cria e atualiza as próprias tabelas na inicialização, antes de aceitar requisições.

A senha é um segredo. Mantenha-a no seu cofre de segredos, como faz com a chave de acesso.

## Todo o resto

A imagem define todos os demais valores. Não defina outras variáveis a menos que a Unico peça: elas não fazem parte da configuração suportada.

## Exemplo

```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 NOME` sem valor repassa a variável do seu shell, de modo que os segredos não aparecem na linha de comando.