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

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

## Where it lives

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

## Related projects

- [[Sources/Dev/github-deploy-refactor|github-deploy-refactor]] — pbsdeploybot + SSH host alias pattern
- [[Sources/Dev/email-to-obsidian-automation|email-to-obsidian-automation]] — Gitea as vault write endpoint
- [[Sources/Dev/email-obsidian-git-pipeline|email-obsidian-git-pipeline]] — email pipeline session notes
- [[Sources/Dev/env-file-hardening|env-file-hardening]] — pbsdeploy credential separation
- [[Wiki/Reference/traefik|traefik]] — ingress layer
- [[Wiki/Reference/n8n|n8n]] — automation that pushes to Gitea

## 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