Self-hosted
Instalar en tu servidor
De una máquina vacía a Forjar respondiendo detrás de HTTPS, con imágenes publicadas y sin compilar nada.
Forjar corre en un host Linux con Docker. El instalador descarga un compose.yml, genera los secretos y arranca todo. Ningún paso edita el código.
Hasta la beta, el repositorio y las imágenes son privados: necesitas un token
de GitHub que pueda leer paquetes de ghcr.io. El comando de forjar.dev
todavía no instala nada.
Requisitos
- Un host Linux que controles. El worker usa el Docker de ese host para arrancar un sandbox por run: dimensiónalo para los runs que quieras en paralelo y no lo compartas con nada que no sea de confianza.
- Docker Engine con el plugin de compose.
docker compose versiondebe funcionar, y tu usuario debe poder usardockersinsudo. - Un dominio que apunte al host y un proxy inverso con HTTPS que gestiones tú: Caddy, nginx, Traefik. GitHub llega a los webhooks de Forjar por esa dirección.
- Mientras sea privado:
docker login ghcr.iocon un token que pueda leer paquetes.
Ejecuta el instalador
curl -fsSL https://raw.githubusercontent.com/erxonxi/forja/main/scripts/install.sh | bashTe pregunta una cosa, la dirección en la que se llegará a Forjar (https://forjar.example.com), lo escribe todo en ./forjar y arranca. Opciones: --dir, --url, --port, --bind, --version, --registry, --source, --yes (no pregunta nada) y --no-start.
Crea tres cosas:
.env, solo legible por ti, con unPOSTGRES_PASSWORDy unFORJA_VAULT_KEYaleatorios y las opciones que diste.secrets/, el directorio del que los contenedores leen los ficheros secretos, con unsession-secretaleatorio.compose.yml, que arranca Postgres, la migración, la API, el worker, la web y el proxy de los sandboxes.
Guarda una copia de FORJA_VAULT_KEY fuera de la máquina. Sin ella no puedo
volver a leer las credenciales que guardo.
Comprueba que responde
curl http://127.0.0.1:8080/api/capabilitiesResponde qué funciones están encendidas. Recién instalado está todo apagado: aún no hay nada configurado y Forjar arranca igual. Cada función se enciende cuando su configuración está completa.
Pon HTTPS delante
La web escucha en 127.0.0.1:8080 (FORJAR_BIND, FORJAR_PORT). Apunta tu proxy inverso ahí. Con Caddy:
forjar.example.com {
reverse_proxy 127.0.0.1:8080
}Una sola dirección sirve la web, la API (/api/) y los webhooks (/webhooks/). Si no se la diste al instalador, ponla en FORJA_PUBLIC_URL dentro de .env.
Puedes volver a ejecutar el instalador cuando quieras: conserva tu .env y tus secretos y lleva la instalación a la --version que le des.