Ga naar inhoud

Gitea - Self-Hosted Git Service

Gitea is een lichtgewicht, snelle en gebruiksvriendelijke self-hosted Git-service geschreven in Go. Het biedt een interface die erg lijkt op GitHub, inclusief issue tracking, pull requests en ingebouwde wiki's, maar dan met een minimale footprint die perfect is voor een homelab cluster.

🚀 Belangrijkste Features

  • Extreem Lichtgewicht: Draait soepel op minimale resources (zeer laag CPU- en RAM-verbruik).
  • Ingebouwde CI/CD: Ondersteuning voor Gitea Actions (compatibel met GitHub Actions workflows).
  • Gebruikersbeheer: Eenvoudige integratie met SSH-sleutels, tweekapsfactorauthenticatie (2FA) en OAuth/Authentik.
  • Webhooks: Perfect te koppelen aan webhooks voor het automatisch builden en deployen van deze MkDocs wiki.

gitea

🛠️ Installatie op Proxmox (LXC)

De snelste en meest schone manier om Gitea als een dedicated LXC-container uit te rollen, is via het community-ondersteunde Proxmox helper-script. Dit script installeert standaard een SQLite3 database.

  1. Log in op de Proxmox VE Shell van je host (pve3).
  2. Voer het officiële Gitea Proxmox VE Helper-Script uit: 
    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 static IP-adressen en storage-allocaties op te geven.
  4. Zodra het script klaar is, vind je Gitea op poort :3000 van het toegewezen IP-adres.

🐋 Alternatief: Docker Compose

Mocht je Gitea in de toekomst liever binnen je Docker VM willen draaien, dan kan dat met dit moderne template (zonder version-regel):

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 Steps

  1. Open je browser en ga naar http://<IP-VAN-LXC>:3000.
  2. Database-instellingen: Selecteer SQLite3 voor een standalone homelab setup. (De databasebestanden worden automatisch lokaal opgeslagen binnen /data).
  3. Algemene instellingen: Pas de Site Title aan naar wens en vul de juiste SSH- en HTTP-domeinnamen in (homelab.patad.nl).
  4. Beheerdersaccount: Scroll helemaal naar beneden en maak direct de eerste Administrator aan. Let op: de allereerste geregistreerde gebruiker wordt automatisch de admin.