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 version debe funcionar, y tu usuario debe poder usar docker sin sudo.
  • 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.io con un token que pueda leer paquetes.

Ejecuta el instalador

curl -fsSL https://raw.githubusercontent.com/erxonxi/forja/main/scripts/install.sh | bash

Te 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 un POSTGRES_PASSWORD y un FORJA_VAULT_KEY aleatorios y las opciones que diste.
  • secrets/, el directorio del que los contenedores leen los ficheros secretos, con un session-secret aleatorio.
  • 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/capabilities

Responde 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.

Siguiente paso