← README
| Variável | Padrão | O quê |
|---|---|---|
DATABASE_URL |
postgres do compose | metadados do portal |
SECRET_KEY |
— | obrigatória em produção (deriva a cifra de segredos) |
PROVISIONING_DRIVER |
docker |
kubernetes materializa cada sistema como Pod — ver driver Kubernetes |
HARNESS_MODE |
opencode (no compose: fake) |
fake = agente determinístico sem LLM (dev/E2E) |
FAKE_DELAY |
0.15 |
ritmo do harness fake em segundos |
BASE_IMAGE |
appaiforge/base:0.1.0 |
imagem dos containers de sistema |
CONTAINER_CPUS / CONTAINER_MEM_MB / CONTAINER_DISK_GB |
2 / 2048 / 10 | limites por sistema (ADR 0013) |
CONTAINER_PIDS_LIMIT |
512 | teto de processos por container (ADR 0018) |
MAX_SYSTEMS |
10 | teto de sistemas simultâneos |
HEALTH_INTERVAL |
15 | sonda de saúde das apps (segundos) |
WORKSPACES_DIR / HOST_WORKSPACES_DIR |
/workspaces | raiz dos workspaces (bind compartilhado) |
DYNAMIC_CONFIG_DIR |
/dynamic | rotas dinâmicas do Traefik (volume compartilhado) |
CONFIGS_DIR / HOST_CONFIG_DIR |
/configs | config do agente (MCP, provedor, chaves) fora do workspace, montada read-only no container do sistema |
DISPLAY_TIMEZONE |
America/Sao_Paulo | fuso das datas exibidas (gravadas em UTC) |
INFERENCE_BROKER_ENABLED |
false |
broker de inferência: token opaco no container + LiteLLM (ADR 0020, ver LLM e broker) |
LITELLM_API_KEY / INFERENCE_BROKER_SERVICE_TOKEN |
— | master key do LiteLLM e segredo portal↔broker (obrigatórias com o broker ligado) |
DB_GATE_MODE |
enforce |
enforce o sidecar recusa bloqueada/confirmável na hora, sem aprovação (ADR 0021/0023); shadow audita sem bloquear — ver Segurança |
DB_GATE_PROXY_SERVICE_TOKEN |
— | segredo compartilhado entre o sidecar e o portal (mesmo padrão do broker) |
SEED_DEMO_ADMIN |
— | 1 semeia o admin de dev quando não há usuários (nunca em produção) |
AUTH_MODE |
local |
local (e-mail/senha) ou oidc (SSO); gravado no primeiro boot, não muda depois — ver Autenticação |
PUBLIC_BASE_URL |
— | URL pública do portal (obrigatória no modo oidc; base do redirect_uri) |
OIDC_ISSUER / OIDC_CLIENT_ID / OIDC_CLIENT_SECRET |
— | IdP e client confidencial (obrigatórios no modo oidc) |
OIDC_INTERNAL_BASE_URL |
— | base interna do IdP para discovery/token/JWKS |
OIDC_SCOPES / OIDC_ROLES_CLAIM / OIDC_GROUPS_CLAIM |
openid email profile / realm_access.roles / groups |
escopos e claims de papel e grupos |
OIDC_REVALIDATE_SECONDS / OIDC_NETWORK_GRACE_SECONDS |
300 / 60 | revalidação da sessão no IdP e tolerância a IdP fora do ar |
BREAKGLASS_EMAIL / BREAKGLASS_PASSWORD_HASH |
— | admin de emergência (hash de appaiforge hash-password) |
BREAKGLASS_SESSION_HOURS |
8 | duração máxima da sessão do break-glass |
LOGIN_RATE_LIMIT_ATTEMPTS / LOGIN_RATE_LIMIT_WINDOW_SECONDS |
5 / 900 | falhas por IP+e-mail que bloqueiam o login local, e a janela |
IDENTITY_TOKEN_TTL_SECONDS |
60 | validade do JWT de identidade entregue às apps |
Limites: CPU/memória aplicados via Docker; quota de disco requer storage driver com suporte a storage-opt (overlay2/ext4 não suporta — o container sobe sem quota e o portal registra a ressalva).