wiki-vault/Wiki/Reference/gitea.md
Travis Herbranson 30e2483e71 lint: fix 4 session-note types, 6 broken wikilinks
- type: session-note -> session-notes (4 files: 2 vault-integration-test, 2 postgres-consolidation phases)
- [[Sources/Homelab/ob1-jsonl-watcher]] -> actual filename (5 links across ob1, ai-memory synthesis, Homelab index)
- [[Sources/Dev/env-file-hardening]] -> Sources/Homelab/env-file-hardening (gitea entity)

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-24 21:30:15 -04:00

2.7 KiB

type path tags created updated
entity Wiki/Reference
gitea
git
docker
2026-05-08 2026-05-24

Gitea

What it is

Gitea is the self-hosted Git service running in the PBS Docker stack. It provides a private Git hosting layer for PBS projects, automation pipelines, and vault writes. Gitea hosts service accounts (like pbsdeploybot) used for CI/CD and automated git operations, keeping machine credentials separate from personal accounts.

Current state

Active. Key roles:

  • pbsdeploybot machine user — Gitea account used by GitHub Actions for PBS deployments; SSH host alias pattern avoids ambiguous key usage
  • Email-to-vault pipeline — Gmail → n8n → Gitea push → vault (Gitea as the git push endpoint for new session notes)
  • Repository hosting — hosts PBS-related private repos alongside GitHub mirrors

The GitHub deploy refactor project completed the migration to pbsdeploybot with Gitea SSH host aliases, replacing the previous ambiguous key setup.

A relocation is planned (Sources/Homelab/gitea-migration-to-pve): promote a new PVE LXC Gitea to canonical for homelab/petal-power repos, keep the PBS instance canonical for PBS business code, and cross-mirror each as the other's insurance copy. The reframe is that PBS-Gitea was already serving as paid offsite backup. Lovebug also pushes vault-mcp commits to Gitea over HTTPS using a lovebug PAT via an env-driven git credential helper (the semicolon-trap and token fixes are documented in the consolidation session notes).

Where it lives

  • PBS Linode Docker stack (gitea service)
  • Behind Traefik ingress
  • Persistent data in Docker volumes

History

  • Ongoing — Self-hosted git service in PBS stack
  • 2026 — pbsdeploybot machine user created; SSH host alias pattern implemented
  • 2026 — Email-to-vault pipeline wired through Gitea as the push endpoint
  • 2026-05 — vault-mcp push surface wired (lovebug PAT + HTTPS credential helper)
  • 2026-05-23 — PVE LXC migration plan written: two-instance cross-mirror, petal-power canonical on the new instance