Ir al contenido

Configuración

TAIA se configura en dos lugares:

  • Variables de entorno del servidor: conexión a la base, puertos, URLs y todo lo que define qué programas puede ejecutar el servidor.
  • Settings guardados en la base, que se editan desde Ajustes o con PUT /api/settings: runtimes, zona horaria, worktrees, webhooks y alertas.

Cuando una opción existe en los dos lugares, el setting de la base gana sobre la variable de entorno, salvo que se indique lo contrario.

Variable Default Notas
DATABASE_URL — Connection string. Si no está, se arma con las POSTGRES_*
POSTGRES_HOST localhost
POSTGRES_PORT 5432 En docker compose, también es el puerto del host
POSTGRES_USER / POSTGRES_DB taia / taia
POSTGRES_PASSWORD taia Obligatoria en producción (sin ella, el contenedor de Postgres no arranca)
TAIA_MIGRATIONS_DIR packages/core/migrations Solo si movés las migraciones

En desarrollo local, los defaults ya apuntan al Postgres de docker compose up -d postgres.

Variable Default Servicio
APP_PORT 13333 Web y API
WS_PORT 13334 WebSocket
BROADCAST_PORT 13335 Broadcast interno
MCP_PORT 13336 Servidor MCP (también el puerto del proceso MCP)

Dentro de los contenedores, los puertos son siempre los mismos. Fuera de Docker, APP_PORT, WS_PORT y BROADCAST_PORT son los puertos en los que escuchan pnpm dev y pnpm start, y las URLs por defecto de abajo los siguen: con valores distintos podés correr dos instancias en la misma máquina.

Variable Default Notas
TAIA_URL http://localhost:13333 URL de TAIA que reciben los agentes para llegar al tablero
WS_CLIENT_URL ws://localhost:13334 URL del WebSocket que usa el navegador. En producción, wss://<dominio>/ws. El setting app.ws_url gana
BROADCAST_URL http://localhost:13335/broadcast Endpoint interno para avisar al WebSocket
DOMAIN localhost Dominio de Caddy (deploy/docker-compose.prod.yml)
MCP_ALLOWED_HOSTS — Hosts extra que acepta el servidor MCP, separados por comas (detrás de un proxy)
Variable Default Notas
TAIA_BIND_HOST 127.0.0.1 (0.0.0.0 en la imagen de Docker) Interfaz en la que escuchan la app, el WebSocket, el broadcast y el MCP fuera de Docker
MCP_HOST el de TAIA_BIND_HOST Lo mismo, solo para el servidor MCP
TAIA_API_TOKEN — Token de acceso (16+ caracteres). Con él, la web, la API, el MCP y el WebSocket piden credenciales. La app y el MCP tienen que compartirlo. Ver Deploy
TAIA_TRUSTED_PROXIES 0 (1 en deploy/docker-compose.prod.yml) Cuántos proxies propios hay delante de la app y agregan la IP del cliente a X-Forwarded-For, como Caddy. Con 0, el freno de intentos fallidos de ingreso cuenta a todos los clientes juntos; con 1 o más, por IP
TAIA_SECRET_KEY — Clave (16+ caracteres) para cifrar en la base los tokens, API keys y secretos de webhooks. La app y el MCP tienen que compartirla. Ver SECURITY
TAIA_WEBHOOK_ALLOW_PRIVATE desactivado Con 1, los webhooks salientes pueden ir a localhost y a redes privadas
Variable Default Notas
TAIA_CLI_COMMAND_CLAUDE_CODE, _AIDER, _CURSOR — Binario de un runtime CLI. Sin esta variable, solo se acepta el binario propio (claude, aider, cursor/cursor-agent)
TAIA_CLI_CWD — Directorio de trabajo de los runtimes CLI. Gana sobre la UI
TAIA_QA_STEPS git status --short, git diff --check Pasos del QA pipeline, como array JSON
TAIA_QA_ARTIFACTS_DIR .taia/qa-runs Logs y resultados del QA pipeline
WORKTREE_SETUP_CMD — Comando que se corre en cada worktree nuevo
TAIA_ALLOW_REMOTE_COMMANDS desactivado Con 1, la API y la UI pueden fijar los pasos de QA, el setup de worktrees y las rutas de worktrees y clones. Solo en un host de confianza
Variable Default Setting que la reemplaza
WORKTREE_BASE_PATH /tmp/taia-worktrees worktree.base_path (solo con TAIA_ALLOW_REMOTE_COMMANDS=1)
WORKTREE_REPO_PATH /tmp/taia-repos worktree.repo_clone_path (solo con TAIA_ALLOW_REMOTE_COMMANDS=1)
WORKTREE_CLEANUP_HOURS 72 worktree.cleanup_hours
WORKTREE_AUTO_CLEANUP activado (salvo false) worktree.auto_cleanup
WORKTREE_AUTO_CREATE desactivado (salvo true) worktree.auto_create_on_assign
Variable Default Notas
CRON_DEFAULT_TZ UTC Zona horaria del cron si no hay setting app.default_tz
TAIA_EXPOSE_DB_IDENTITY desactivado Con 1, /api/runtime-target muestra usuario, host y base sin hashear
NEXT_TELEMETRY_DISABLED 1 en la imagen Telemetría de Next.js
Variable Default Usada por
TAIA_API http://localhost:13333 CLI taia
TAIA_TOKEN — CLI taia: el token de acceso de la instancia, si tiene
TAIA_APP_URL, TAIA_MCP_URL http://127.0.0.1:13333, http://127.0.0.1:13336/mcp scripts/dev/check-*
TAIA_WORKSPACE_ID ws-default scripts/dev/check-*
TAIA_CHECK_TIMEOUT_SECONDS 5 scripts/dev/check-*

Las variables de los tests (TEST_DATABASE_URL, OPENCLAW_GATEWAY_*) están en CONTRIBUTING.

Clave Para qué Dónde se edita
runtime.providers.<provider>.*, runtime.default_provider Configuración de los runtimes. Se aplica a la instancia del mismo nombre Ajustes › Runtime
runtime.instances.<id>.* Secretos y estado de cada instancia (token, API key, identidad del dispositivo) La escribe TAIA
app.ws_url URL del WebSocket para el navegador Ajustes › General
app.default_tz Zona horaria por defecto Ajustes › General
worktree.* Rutas y comportamiento de los worktrees Ajustes › Worktrees
webhooks.incoming.<ws>.secret Secreto de los webhooks entrantes API
webhooks.outgoing.<ws>.endpoints Endpoints de los webhooks salientes (JSON) API
telegram_target, alerts.channel Destinatario y canal de las alertas, enviadas por el runtime (capacidad messaging) API

Las claves sensibles (tokens, API keys, identidades) vuelven enmascaradas al leerlas. En la base se guardan cifradas solo si definís TAIA_SECRET_KEY; sin ella quedan en texto plano.