Gitea – dein Git im Homelab

Ich hatte erst über GitLab geschrieben und war damit auch nicht sehr zufrieden. Das hatte mehrere Gründe. Einmal war GitLab sehr RAM hungrig, ich hatte Probleme mit der Installation und auch später mit dem selbst signiertem SSL Zertifikat.
Durch die Fehler suche bin ich dann auf Gitea gestoßen. Gitea verfolgt den gleichen Ansatz, ist allerdings schlanker, die Installation ist einfacher. Allein der erste Start des Containers, Gitea war sofort erreichbar. Nachdem der Container ausgerollte wurde und man die Anwendung im Browser aufgerufen hat, wird man an die Hand genommen. Ich konnte mich für eine Datenbank entscheiden, einen Mail SMTP Zugang einrichten und den Admin einstellen. Es wirkt einsteigerfreundlicher.

Doch auch über Gitea kursiert eine Nachricht die vielleicht den ein oder anderen Abschreckt. Seit 2022 ist Gitea kommerziell. Wer dazu mehr erfahren möchte, hier das pricing: https://about.gitea.com/pricing/

Für die, die Gitea bei sich betreiben möchten, soll es kostenlos bleiben unter der Open Source MIT Lizenz.

Installation

Die Installation ist denkbar einfach. Docker und Docker-Compose müssen bereits installiert sein. Bei mir läuft die Anwendung in einem LXC.

Leg in deinem Docker Verzeichnis einen neuen Ordner an. Hier hat jeder andere Vorlieben z.B. ins Home Verzeichnis oder einige installieren die Anwendungen auch in /opt/stacks (z.B. die Anwendung Docker-Compose Verwaltungssoftware dockge).

mkdir gitea && cd gitea

Hier legst du einen neue Datei und öffnest diese mit nano

nano docker-compose.yml

und fügst folgenden Text ein

---
networks:
  gitea:
    external: false

services:
  server:
    image: docker.gitea.com/gitea:latest
    container_name: gitea
    environment:
      - USER_UID=1000
      - USER_GID=1000
    restart: unless-stopped
    networks:
      - gitea
    volumes:
      - ./data:/data
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
    ports:
      - "3000:3000"
      - "222:22"

Was ggf. geändert werden muss, ist der Port. Sollte der bei dir belegt sein, kannst du den ändern.
Beispiel:

4000:3000

Die Zahl vor dem Doppelpunkt bitte nur. Im Browser unter http://DEINE-IP:4000 ist Gitea dann erreichbar. Port 222 ist der ssh Port.

Nun nur noch den Container ausrollen

docker-compose up -d

Installation in der GUI

Wenn du Gitea im Browser unter http://DEINE-IP:4000 aufrufst, wirst du begrüßt mit ein paar Einstellungen. Ich habe mir die Zeit genommen das einmal sauber zu installieren. Angefangen mit der Datenbank! Ich habe mich für die empfohlene Datenbank entschieden. Ich glaube das war SQ-Lite. Die wird mir reichen. Möchtest du z.B. MySQL oder PostgreSQL haben, musst das Dockerskript anpassen. Unter der Dokumentation von Gitea findest du das fertige Docker-Compose file.

Dann kommt noch die Mail SMTP Einstellung und die Admin Einstellung. Einmal alles ausfüllen. Ich habe mir davon eine pdf erstellt und diese in meinen Passwortmanager mit angehangen. Dies kannst du unter Mac mit CMD + P und dann in den Druckereinstellungen auf pdf Speichern gehen.

Ja und das war schon die ganze Installation.