Forgejo¶

Forge git self-hosted para versionar todo el homelab. Fork comunitario de Gitea (Codeberg), 100% FOSS.

Datos¶

URL: https://git.matias7235.com.ar
Puerto web: 8524 (registrado en nextport)
Puerto SSH (git): 2222
Stack: /opt/docker/forgejo/ (SQLite, sin DB externa)
Usuario: matias (admin, registro público deshabilitado)
Instalado: julio 2026, Forgejo 15.0.3

Repos¶

Repo	Contenido	Working copy
`homelab-infra`	Composes de /opt/docker, Caddyfile, /opt/scripts, config MkDocs	`/opt` (whitelist)
`homelab-agents`	Agentes/skills OpenCode + opencode.jsonc	`~/.config/opencode`
`docs-tools`	Editor Flask	`/opt/docs`
`notas`	Estas notas Markdown	`~/proyectos/selfhosted`

Pendiente: migrar secretos literales a .env en collabora, firecrawl, immich, kan y nextcloud — hasta entonces esos composes estan excluidos de homelab-infra (ver su .gitignore).

Uso diario¶

# clonar
git clone git@git.matias7235.com.ar:matias/<repo>.git   # SSH puerto 2222
git clone https://git.matias7235.com.ar/matias/<repo>.git

# push desde una working copy ya inicializada
git add -A && git commit -m "mensaje" && git push origin main

Para SSH agregar en ~/.ssh/config:

Host git.matias7235.com.ar
    Port 2222

Reglas¶

Secretos NUNCA en git: .env, users.json, tokens → .gitignore. Los secretos viven en Vaultwarden.
Los data/ de cada stack no se versionan (solo composes y configs).
Imagen con versión fijada — actualizar el tag a mano tras revisar release notes.

Troubleshooting¶

docker logs forgejo --tail 50
docker compose -f /opt/docker/forgejo/compose.yaml restart

El backup del homelab ya cubre Forgejo completo (respalda /opt/docker, incluye ./data con repos y DB).