Self-hosted
Configuración
Cada función tiene su interruptor. Lo que no está configurado está apagado, y Forjar arranca sin ello.
Todo se configura en .env; el compose.yml se lo pasa a la API y al worker. Los mismos interruptores configuran el cloud de Forjar. Después de cambiar algo:
docker compose up -dAcceso y GitHub
| Variable | Por defecto | Qué hace |
|---|---|---|
FORJA_PUBLIC_URL | http://localhost:8080 | Dónde llega el navegador a Forjar |
GITHUB_APP_ID | vacía, apagado | La GitHub App: repositorios, webhooks y PRs |
GITHUB_CLIENT_ID | vacía, apagado | El client id de la app, para entrar. Sin él no hay cabina |
FORJA_SIGNUP | closed | Quién abre cuenta: closed (administradores e invitados de un propietario), invite (también quien tenga un enlace de access invite) u open |
FORJA_ADMIN_EMAILS | vacía | Emails verificados de GitHub de quien opera la instalación, separados por comas |
FORJA_HUMAN_REVIEWERS | vacía | Logins extra cuya aprobación cuenta como humana en todos los equipos |
FORJA_TRIGGER_LABEL | forja | La etiqueta que le da una issue a Forjar |
Runs y sandboxes
| Variable | Por defecto | Qué hace |
|---|---|---|
FORJA_WORKER_CONCURRENCY | 1 | Runs a la vez por proceso worker; dimensiónalo a tu host |
FORJA_MAX_RUNS_PER_ORGANIZATION | 2 | Runs a la vez de un mismo equipo, para que ninguno deje sin turno a los demás |
FORJA_RECONCILE_INTERVAL_SECONDS | 300 | Cada cuánto compara los PRs abiertos con GitHub; 0 lo apaga |
FORJA_SANDBOX_PROVIDER | docker | Dónde se crean los sandboxes: docker o daytona |
FORJA_EGRESS_ALLOW_EXTRA | vacía | Hosts extra a los que pueden salir los sandboxes, además de GitHub y los proveedores de los agentes. Solo HTTPS en el 443 |
DAYTONA_API_KEY | vacía, apagado | Una clave de Daytona Cloud. Ver Sandboxes en Daytona |
FORJA_DAYTONA_SNAPSHOT | vacía | El snapshot de Daytona construido desde la imagen forjar-sandbox |
FORJA_DAYTONA_IMAGE | vacía | Una imagen que Daytona pueda descargar, si no hay snapshot |
DAYTONA_API_URL | la de Daytona | Solo para un Daytona propio |
DAYTONA_TARGET | la de Daytona | La región en la que corren los sandboxes |
FORJA_CODEX_LOGIN_RENEW_BY | vacía | Fecha antes de la que hay que renovar el login de Codex de la instalación |
FORJA_CODEX_LOGIN_WARN_DAYS | 7 | Días antes de esa fecha en los que el worker empieza a avisar |
El chat
| Variable | Por defecto | Qué hace |
|---|---|---|
FORJA_ASSISTANT_API_KEY | vacía, apagado | La clave del modelo del chat, que pagas tú |
FORJA_ASSISTANT_PROVIDER | anthropic | anthropic, openai, openrouter u openai_compatible (este necesita FORJA_ASSISTANT_BASE_URL) |
FORJA_ASSISTANT_MODEL | el del proveedor | El modelo del chat |
FORJA_ASSISTANT_MONTHLY_CAP_USD | 20 | Lo que puede costar el chat a cada equipo cada mes; none sin tope |
FORJA_CLAUDE_SUBSCRIPTION_LOGIN | true | Deja que un equipo entre en Claude con su suscripción; false deja solo la API key |
Linear, correo y conectores
| Variable | Por defecto | Qué hace |
|---|---|---|
LINEAR_CLIENT_ID | vacía, apagado | Enciende Linear. Ver Linear |
FORJA_SMTP_HOST | vacía, apagado | El servidor de correo para los avisos de «te espera»; con FORJA_SMTP_PORT (587), FORJA_SMTP_SECURE (false), FORJA_SMTP_USER, FORJA_SMTP_FROM y FORJA_SMTP_TO |
FORJA_MCP_ALLOW_PRIVATE_ENDPOINTS | false | Deja que los conectores estén en una red privada o usen http |
FORJA_MCP_GATEWAY_URL | FORJA_PUBLIC_URL + /mcp-gateway | Por dónde llegan los agentes de los runs a los conectores de su equipo. Añade su host a FORJA_EGRESS_ALLOW_EXTRA |
FORJA_WAITLIST_ORIGINS | vacía, apagado | Sitios cuyo formulario puede escribir en la lista de espera |
Almacenamiento y cifrado
| Variable | Por defecto | Qué hace |
|---|---|---|
DATABASE_URL | la construye el compose.yml | La conexión a Postgres. Su usuario aplica el esquema y crea una vez el rol forja_app; la aplicación corre como forja_app |
FORJA_MIGRATE_ON_START | false en el compose.yml | Si este proceso aplica el esquema al arrancar; lo hace el contenedor migrate |
FORJA_VAULT_KEY | la genera el instalador | La clave que sella cada credencial guardada; 32 caracteres o más |
FORJA_VAULT_PREVIOUS_KEYS | vacía | Las claves a las que sustituyó, durante una rotación. Ver Operar |
FORJA_STORAGE_BUCKET | vacía, usa el disco | Un bucket S3 para transcripciones y extensiones; con FORJA_STORAGE_ENDPOINT, FORJA_STORAGE_REGION (us-east-1), FORJA_STORAGE_ACCESS_KEY_ID, FORJA_STORAGE_SECRET_ACCESS_KEY, FORJA_STORAGE_PREFIX y FORJA_STORAGE_PATH_STYLE (false, ponlo a true para MinIO) |
FORJA_CONTENT_ENCRYPTION | true | Cifra el contenido antes de subirlo a S3 |
La instalación
Las fija el instalador y las usa el compose.yml:
| Variable | Por defecto | Qué hace |
|---|---|---|
POSTGRES_PASSWORD | la genera el instalador | La contraseña del Postgres incluido |
FORJAR_VERSION | edge | La etiqueta de las imágenes |
FORJAR_REGISTRY | ghcr.io/erxonxi | De dónde vienen las imágenes |
FORJAR_PORT | 8080 | Puerto local de la web |
FORJAR_BIND | 127.0.0.1 | Dirección local en la que escucha |
DOCKER_GID | el grupo del socket de Docker | Deja que el worker use el Docker del host |
FORJA_SECRETS_HOST_DIR | ./secrets | El directorio del host con los ficheros secretos |
Las fija el compose.yml dentro de los contenedores, y no hay motivo para cambiarlas:
| Variable | Valor | Qué es |
|---|---|---|
FORJA_SECRETS_DIR | /run/secrets | Dónde leen los contenedores los ficheros secretos |
FORJA_ARTIFACTS_DIR | /var/lib/forja/artifacts | Las transcripciones de los runs cuando no hay S3; la API y el worker lo comparten |
FORJA_SANDBOX_IMAGE | la imagen forjar-sandbox | La imagen de la que arranca el sandbox de cada run |
FORJA_EGRESS_CONTAINER | forja-egress | El proxy por el que los sandboxes salen a la red |
FORJA_WEB_DIR | sin fijar | Una web compilada para que la sirva la API: solo la usa la imagen combinada |
Ficheros secretos
Van en secrets/, con permiso 660. Nunca en .env, en el chat ni en un commit.
| Fichero | Qué es |
|---|---|
session-secret | Firma la cookie de sesión. Lo genera el instalador |
github-app-private-key | El .pem de la GitHub App |
github-webhook-secret | El secreto de los webhooks de la app |
github-oauth-client-secret | El client secret de la app |
claude-code-oauth-token | Opcional: el login de Claude de la instalación |
codex-auth.json | Opcional: el login de Codex de la instalación |
smtp-password | Con FORJA_SMTP_USER: la contraseña del correo |
linear-oauth-client-secret | Con Linear: el client secret de la app de Linear |
linear-webhook-secret | Con Linear: el secreto de sus webhooks |
Avanzadas
El compose.yml no pasa estas: añádelas al environment de la API y del worker para cambiarlas. FORJA_AGENT_TIMEOUT_MS, FORJA_AGENT_STOP_GRACE_MS, FORJA_CLAUDE_MODEL, FORJA_CODEX_MODEL, FORJA_ASSISTANT_BASE_URL, FORJA_ASSISTANT_INPUT_USD_PER_MTOK, FORJA_ASSISTANT_OUTPUT_USD_PER_MTOK, FORJA_REVIEWER, FORJA_WORKER_IDLE_MS y FORJA_WORKER_HEARTBEAT_MS.
Los precios de los modelos de los runs no son variables: viven en el catálogo de proveedores. Las dos FORJA_ASSISTANT_*_USD_PER_MTOK son solo para un modelo del chat que el catálogo no tiene.