Ga naar inhoud

☕ Gitea - Self-Hosted Git & CI/CD Platform

Gitea is een lichtgewicht, extreem snelle en gebruiksvriendelijke self-hosted Git-service geschreven in Go. Het biedt een interface die sterk lijkt op GitHub, inclusief issue tracking, pull requests, container registries en ingebouwde wiki's. Door de minimale footprint is het de ultieme Git-oplossing voor een Proxmox homelab cluster.

🏗️ Wat kan Gitea betekenen in jouw Homelab?

Binnen een geavanceerd homelab fungeert Gitea als de centrale 'Single Source of Truth'. Het tilt je omgeving naar een professioneel niveau door code, configuraties en automatisering lokaal te hosten.

1. GitOps & Infrastructuur als Code (IaC)

In plaats van handmatig containers aan te maken of instellingen aan te passen in Proxmox, sla je al je docker-compose.yml bestanden, Proxmox LXC-scripts en netwerkconfiguraties op in Git-repositories. Dit zorgt voor versiebeheer: je kunt altijd terug naar een werkende configuratie als een update mislukt.

2. Geautomatiseerde MkDocs CI/CD (Gitea Actions)

Gitea heeft een ingebouwd CI/CD-systeem genaamd Gitea Actions (volledig compatibel met GitHub Actions). Hiermee kun je deze Spruitmans Homelab Wiki automatiseren: * Je typt een nieuwe .md pagina op je pc of laptop. * Je doet een git push naar je lokale Gitea container. * Gitea Actions merkt dit op, bouwt de MkDocs site automatisch op de achtergrond en pushed de kant-en-klare HTML-bestanden direct naar je webserver of Nginx Proxy Manager.

3. Back-up van Configuraties & Scripts

Sla al je handige cronjobs, back-up scripts (voor TrueNAS en PBS) en Home Assistant YAML-bestanden centraal op. Mocht een VM of LXC crashen, dan staan je configuratiebestanden veilig in Gitea en rol je de service binnen enkele minuten weer hersteld uit.

4. Volledige Privacy & Lokale Snelheid

Je code en homelab-geheimen (zoals API-tokens en wachtwoorden in je compose-bestanden) verlaten nooit je eigen netwerk. Omdat alles op je eigen Proxmox-cluster (pve3) draait, zijn git clone en git push commando's razendsnel via het lokale netwerk.

🚀 Belangrijkste Technische Features

  • Extreem Resource-vriendelijk: Draait moeiteloos op een heel lichte LXC-container met slechts 512MB RAM en een fractie van een CPU-core.
  • Ingebouwde Container Registry: Sla je eigen op maat gemaakte Docker-images lokaal op.
  • Authentik Integratie: Eenvoudig te koppelen aan je centrale Authentik VM via OAuth2/OIDC voor Single Sign-On (SSO).
  • Uitgebreide Webhooks: Koppel Gitea aan Discord, Telegram of Gotify om notificaties te ontvangen wanneer er wijzigingen in je homelab worden doorgevoerd.

🛠️ Installatie op Proxmox (LXC)

De meest efficiënte methode om Gitea uit te rollen is via een dedicated LXC-container met een SQLite3 database.

  1. Log in op de Proxmox VE Shell van de host (pve3).
  2. Start het officiële community helper-script: 
    bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/gitea.sh)"
  3. Volg de stappen op het scherm. Kies voor Default voor een snelle installatie, of Advanced om handmatig statische IP-adressen en opslaglocaties toe te wijzen.
  4. Na afronding is de webinterface bereikbaar op poort :3000 van het toegekende IP-adres.

pulse

🐋 Alternatieve Installatie via Docker Compose

Draai je Gitea liever in je centrale Docker VM? Gebruik dan dit moderne template:

services:
  server:
    image: gitea/gitea:latest
    container_name: gitea
    environment:
      - USER_UID=1000
      - USER_GID=1000
    restart: always
    volumes:
      - ./gitea-data:/data
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
    ports:
      - "3000:3000"
      - "2222:22"

⚙️ Eerste Configuratie & Post-Installatie

  1. Navigeer in de browser naar http://<IP-VAN-LXC>:3000.
  2. Database: Selecteer SQLite3 voor een standalone homelab setup. De database wordt automatisch lokaal opgeslagen binnen /data.
  3. Server Domein: Vul hier je homelab-domein in (bijv. gitea.patad.nl of het lokale IP-adres).
  4. Beheerdersaccount: Scroll naar beneden en maak direct onderaan de pagina het eerste Administrator-account aan. De allereerste geregistreerde gebruiker krijgt automatisch admin-rechten.