Self-hosted

Operar la instalación

Actualizar, hacer copias, leer los logs, parar y rotar claves.

Todos los comandos se ejecutan en el directorio de la instalación.

Actualizar

Vuelve a ejecutar el instalador con la versión que quieras (--version), o cambia FORJAR_VERSION en .env y:

docker compose pull && docker compose up -d

La migración corre primero; la API y el worker la esperan.

Hacer copias

Guarda cuatro cosas:

  • El volumen forja-postgres:

    docker compose exec postgres pg_dump -U forja forja > forjar.sql
  • El volumen forja-artifacts, salvo que uses S3.

  • El directorio secrets/ y el fichero .env.

  • FORJA_VAULT_KEY, además, en otro sitio: un gestor de contraseñas, aparte de la copia de la base de datos.

Si pierdes la clave del vault, cada credencial guardada queda ilegible y hay que darla otra vez. La copia de la base de datos sola no puede abrirlas, y nadie que lea solo la base de datos tampoco.

Logs

docker compose logs -f api worker

Nunca contienen tokens.

Parar

  • docker compose down para y conserva los datos.
  • docker compose down -v para y borra los datos.

Parar el worker espera hasta 35 minutos a que termine el run que tiene entre manos.

Rotar la clave del vault

Genera una clave nueva

En tu ordenador, no en el servidor:

openssl rand -base64 32

Pon la nueva y conserva la vieja

En .env, la nueva en FORJA_VAULT_KEY y la anterior en FORJA_VAULT_PREVIOUS_KEYS (separadas por comas si hay varias). Aplica con docker compose up -d.

Todo se sigue abriendo, y la API lo vuelve a sellar con la clave nueva al arrancar: logins, API keys, conectores y claves de Daytona de cada equipo, y después el contenido guardado.

Quita la vieja

Cuando el log de la API diga FORJA_VAULT_PREVIOUS_KEYS can be removed, espera a que terminen los runs en curso, quítala y aplica otra vez. Si dice que algunos objetos no se pudieron leer, consérvala.

Puedes rotar session-secret cuando quieras: solo firma las cookies, así que cierra la sesión de todos y no sella nada.

Renovar el login de Codex de la instalación

Solo si dejaste codex-auth.json en secrets/. Lo que cada equipo conecta desde la cabina lo renueva Forjar.

  1. En una máquina de confianza, codex login --device-auth y aprueba en el navegador. Escribe ~/.codex/auth.json.
  2. Cópialo sobre secrets/codex-auth.json. El siguiente run lo lee, sin reiniciar.
  3. No uses ese login en otra máquina después: Codex rota el token de refresco al usarlo y la otra copia dejaría de funcionar.

Con FORJA_CODEX_LOGIN_RENEW_BY el worker avisa los días previos (FORJA_CODEX_LOGIN_WARN_DAYS, 7 por defecto).

Un sandbox que dejó un fallo

Se llama forja-run-<id> y su red forja-net-<id>. Bórralos:

docker rm -f forja-run-<id>
docker network rm forja-net-<id>