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 -d

Acceso y GitHub

VariablePor defectoQué hace
FORJA_PUBLIC_URLhttp://localhost:8080Dónde llega el navegador a Forjar
GITHUB_APP_IDvacía, apagadoLa GitHub App: repositorios, webhooks y PRs
GITHUB_CLIENT_IDvacía, apagadoEl client id de la app, para entrar. Sin él no hay cabina
FORJA_SIGNUPclosedQuién abre cuenta: closed (administradores e invitados de un propietario), invite (también quien tenga un enlace de access invite) u open
FORJA_ADMIN_EMAILSvacíaEmails verificados de GitHub de quien opera la instalación, separados por comas
FORJA_HUMAN_REVIEWERSvacíaLogins extra cuya aprobación cuenta como humana en todos los equipos
FORJA_TRIGGER_LABELforjaLa etiqueta que le da una issue a Forjar

Runs y sandboxes

VariablePor defectoQué hace
FORJA_WORKER_CONCURRENCY1Runs a la vez por proceso worker; dimensiónalo a tu host
FORJA_MAX_RUNS_PER_ORGANIZATION2Runs a la vez de un mismo equipo, para que ninguno deje sin turno a los demás
FORJA_RECONCILE_INTERVAL_SECONDS300Cada cuánto compara los PRs abiertos con GitHub; 0 lo apaga
FORJA_SANDBOX_PROVIDERdockerDónde se crean los sandboxes: docker o daytona
FORJA_EGRESS_ALLOW_EXTRAvacíaHosts 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_KEYvacía, apagadoUna clave de Daytona Cloud. Ver Sandboxes en Daytona
FORJA_DAYTONA_SNAPSHOTvacíaEl snapshot de Daytona construido desde la imagen forjar-sandbox
FORJA_DAYTONA_IMAGEvacíaUna imagen que Daytona pueda descargar, si no hay snapshot
DAYTONA_API_URLla de DaytonaSolo para un Daytona propio
DAYTONA_TARGETla de DaytonaLa región en la que corren los sandboxes
FORJA_CODEX_LOGIN_RENEW_BYvacíaFecha antes de la que hay que renovar el login de Codex de la instalación
FORJA_CODEX_LOGIN_WARN_DAYS7Días antes de esa fecha en los que el worker empieza a avisar

El chat

VariablePor defectoQué hace
FORJA_ASSISTANT_API_KEYvacía, apagadoLa clave del modelo del chat, que pagas tú
FORJA_ASSISTANT_PROVIDERanthropicanthropic, openai, openrouter u openai_compatible (este necesita FORJA_ASSISTANT_BASE_URL)
FORJA_ASSISTANT_MODELel del proveedorEl modelo del chat
FORJA_ASSISTANT_MONTHLY_CAP_USD20Lo que puede costar el chat a cada equipo cada mes; none sin tope
FORJA_CLAUDE_SUBSCRIPTION_LOGINtrueDeja que un equipo entre en Claude con su suscripción; false deja solo la API key

Linear, correo y conectores

VariablePor defectoQué hace
LINEAR_CLIENT_IDvacía, apagadoEnciende Linear. Ver Linear
FORJA_SMTP_HOSTvacía, apagadoEl 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_ENDPOINTSfalseDeja que los conectores estén en una red privada o usen http
FORJA_MCP_GATEWAY_URLFORJA_PUBLIC_URL + /mcp-gatewayPor 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_ORIGINSvacía, apagadoSitios cuyo formulario puede escribir en la lista de espera

Almacenamiento y cifrado

VariablePor defectoQué hace
DATABASE_URLla construye el compose.ymlLa 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_STARTfalse en el compose.ymlSi este proceso aplica el esquema al arrancar; lo hace el contenedor migrate
FORJA_VAULT_KEYla genera el instaladorLa clave que sella cada credencial guardada; 32 caracteres o más
FORJA_VAULT_PREVIOUS_KEYSvacíaLas claves a las que sustituyó, durante una rotación. Ver Operar
FORJA_STORAGE_BUCKETvacía, usa el discoUn 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_ENCRYPTIONtrueCifra el contenido antes de subirlo a S3

La instalación

Las fija el instalador y las usa el compose.yml:

VariablePor defectoQué hace
POSTGRES_PASSWORDla genera el instaladorLa contraseña del Postgres incluido
FORJAR_VERSIONedgeLa etiqueta de las imágenes
FORJAR_REGISTRYghcr.io/erxonxiDe dónde vienen las imágenes
FORJAR_PORT8080Puerto local de la web
FORJAR_BIND127.0.0.1Dirección local en la que escucha
DOCKER_GIDel grupo del socket de DockerDeja que el worker use el Docker del host
FORJA_SECRETS_HOST_DIR./secretsEl directorio del host con los ficheros secretos

Las fija el compose.yml dentro de los contenedores, y no hay motivo para cambiarlas:

VariableValorQué es
FORJA_SECRETS_DIR/run/secretsDónde leen los contenedores los ficheros secretos
FORJA_ARTIFACTS_DIR/var/lib/forja/artifactsLas transcripciones de los runs cuando no hay S3; la API y el worker lo comparten
FORJA_SANDBOX_IMAGEla imagen forjar-sandboxLa imagen de la que arranca el sandbox de cada run
FORJA_EGRESS_CONTAINERforja-egressEl proxy por el que los sandboxes salen a la red
FORJA_WEB_DIRsin fijarUna 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.

FicheroQué es
session-secretFirma la cookie de sesión. Lo genera el instalador
github-app-private-keyEl .pem de la GitHub App
github-webhook-secretEl secreto de los webhooks de la app
github-oauth-client-secretEl client secret de la app
claude-code-oauth-tokenOpcional: el login de Claude de la instalación
codex-auth.jsonOpcional: el login de Codex de la instalación
smtp-passwordCon FORJA_SMTP_USER: la contraseña del correo
linear-oauth-client-secretCon Linear: el client secret de la app de Linear
linear-webhook-secretCon 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.