So installieren Sie Gitea auf Ubuntu 24.04 LTS

In diesem Tutorial zeigen wir Ihnen, wie Sie Gitea auf Ubuntu 24.04 LTS installieren. Gitea ist ein leistungsstarker, quelloffener, selbstgehosteter Git-Dienst, der eine benutzerfreundliche Oberfläche für die Verwaltung von Repositories, die Zusammenarbeit mit Teammitgliedern und die Optimierung Ihres Entwicklungsworkflows bietet. Mit seinem leichtgewichtigen Design und der plattformübergreifenden Kompatibilität ist Gitea eine ausgezeichnete Wahl für Einzelpersonen und Organisationen, die ihren eigenen Git-Dienst ohne die Komplexität und den Ressourcenaufwand anderer Lösungen hosten möchten.

Dieser Artikel setzt voraus, dass Sie über Grundkenntnisse in Linux verfügen, wissen, wie man die Shell benutzt, und, was am wichtigsten ist, dass Sie Ihre Site auf Ihrem eigenen VPS hosten. Die Installation ist recht einfach und setzt voraus, dass Sie das Root-Konto verwenden. Wenn nicht, müssen Sie möglicherweise ‚sudo‚ zu den Befehlen hinzu, um Root-Rechte zu erhalten. Ich zeige Ihnen die schrittweise Installation von Gitea auf Ubuntu 24.04 (Noble Numbat). Sie können die gleichen Anweisungen auch für Ubuntu 22.04 und jede andere Debian-basierte Distribution wie Linux Mint, Elementary OS, Pop!_OS und mehr befolgen.

Voraussetzungen

  • Ein Server, auf dem eines der folgenden Betriebssysteme läuft: Ubuntu und jede andere Debian-basierte Distribution wie Linux Mint.
  • Um potenzielle Probleme zu vermeiden, wird eine Neuinstallation des Betriebssystems empfohlen.
  • SSH-Zugriff auf den Server (oder öffnen Sie einfach Terminal, wenn Sie an einem Desktop sitzen).
  • Eine aktive Internetverbindung. Sie benötigen eine Internetverbindung, um die erforderlichen Pakete und Abhängigkeiten herunterzuladen.
  • Ein Ubuntu 24.04-System mit Root-Zugriff oder ein Benutzer mit Sudo-Berechtigungen.

Installieren Sie Gitea auf Ubuntu 24.04 LTS Noble Numbat

Schritt 1. Aktualisieren des Paket-Repositorys.

Aktualisieren und upgraden Sie zunächst alle Systempakete auf die neuesten Versionen. Dadurch wird sichergestellt, dass Sie über die aktuellsten Sicherheitsupdates und Softwareversionen verfügen.

sudo apt update
sudo apt upgrade

Diese Befehle aktualisieren die Paketlisten und aktualisieren alle installierten Pakete auf die neuesten Versionen.

Schritt 2. Abhängigkeitspakete installieren.

Um die erforderlichen Pakete zu installieren, führen Sie die folgenden Befehle aus:

sudo apt update
sudo apt install git sqlite3 nginx

Überprüfen Sie die Git-Installation, indem Sie ihre Version prüfen:

git --version

Schritt 3. Erstellen Sie einen dedizierten Git-Benutzer.

Um die Sicherheit zu erhöhen und Gitea von anderen Systemprozessen zu isolieren, erstellen Sie einen dedizierten Benutzer zum Ausführen von Gitea:

sudo adduser --system --shell /bin/bash --gecos 'Git Version Control' --group --disabled-password --home /home/git git

Dieser Befehl erstellt einen neuen Benutzer mit dem Namen „git“ mit einem Home-Verzeichnis bei /home/gitdie zu einer Gruppe gehört, die auch „git„. Der Benutzer ist als Systemkonto ohne Passwort eingerichtet und verwendet /bin/bash als Standard-Shell.

Schritt 4. Gitea auf Ubuntu 24.04 installieren.

Besuchen Sie die offizielle Gitea-Website und Laden Sie die neueste Binärversion herunter passend für Ihre Systemarchitektur. Für diese Anleitung verwenden wir die gitea-1.22.0-linux-amd64 binär:

wget https://dl.gitea.com/gitea/1.22.0/gitea-1.22.0-linux-amd64

Erstellen Sie als Nächstes die erforderlichen Verzeichnisse für Gitea und legen Sie die entsprechenden Berechtigungen fest:

sudo mkdir -p /var/lib/gitea/{custom,data,log}
sudo chown -R git:git /var/lib/gitea/
sudo chmod -R 750 /var/lib/gitea/
sudo mkdir /etc/gitea
sudo chown root:git /etc/gitea
sudo chmod 770 /etc/gitea

Diese Befehle erstellen die erforderliche Verzeichnisstruktur für Gitea, weisen dem Benutzer und der Gruppe „git“ den Besitz zu und legen die entsprechenden Berechtigungen für jedes Verzeichnis fest.

Schritt 5. Konfigurieren Sie Gitea.

Um Gitea zu konfigurieren, können Sie entweder das Webinstallationsprogramm verwenden oder die Konfigurationsdatei manuell bearbeiten. Für diese Anleitung verwenden wir die manuelle Methode. Erstellen Sie eine neue Konfigurationsdatei mit dem Namen app.ini im /etc/gitea Verzeichnis:

sudo nano /etc/gitea/app.ini

Fügen Sie der Datei den folgenden Inhalt hinzu und passen Sie die Werte nach Bedarf an:

(database)
DB_TYPE = sqlite3
PATH = /var/lib/gitea/data/gitea.db

(repository)
ROOT = /var/lib/gitea/data/repositories

(server)
APP_DATA_PATH = /var/lib/gitea/data
DOMAIN = your-domain.com
SSH_DOMAIN = your-domain.com
HTTP_PORT = 3000
ROOT_URL = https://your-domain.com/
DISABLE_SSH = false
SSH_PORT = 22
SSH_LISTEN_PORT = 22
LFS_START_SERVER = true

(mailer)
ENABLED = false

(service)
REGISTER_EMAIL_CONFIRM = false
ENABLE_NOTIFY_MAIL = false
DISABLE_REGISTRATION = false
ENABLE_CAPTCHA = true
REQUIRE_SIGNIN_VIEW = false

(picture)
DISABLE_GRAVATAR = false

(session)
PROVIDER = file

(log)
MODE = file
LEVEL = info
ROOT_PATH = /var/lib/gitea/log

Speichern Sie die Datei und beenden Sie den Editor. Laden Sie anschließend die systemd Konfiguration, aktivieren Sie den Start des Gitea-Dienstes beim Booten und starten Sie den Dienst:

sudo systemctl daemon-reload
sudo systemctl enable gitea
sudo systemctl start gitea

Überprüfen Sie, ob der Gitea-Dienst ausgeführt wird:

sudo systemctl status gitea

Wenn alles richtig eingerichtet ist, sollten Sie eine Ausgabe sehen, die angibt, dass der Gitea-Dienst aktiv und ausgeführt wird.

Schritt 6. Konfigurieren Sie Nginx als Reverse-Proxy.

Um mit Ihrem Domänennamen auf Gitea zuzugreifen und SSL/TLS zu aktivieren, konfigurieren Sie Nginx als Reverse-Proxy. Erstellen Sie eine neue Nginx-Konfigurationsdatei für Gitea:

sudo nano /etc/nginx/sites-available/gitea

Fügen Sie der Datei den folgenden Inhalt hinzu und ersetzen Sie your-domain.com durch Ihren tatsächlichen Domänennamen:

server {
    listen 80;
    server_name your-domain.com;

    location / {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Speichern Sie die Datei und beenden Sie den Editor. Aktivieren Sie dann die Nginx-Konfiguration, indem Sie einen symbolischen Link erstellen:

sudo ln -s /etc/nginx/sites-available/gitea /etc/nginx/sites-enabled/

Testen Sie die Nginx-Konfiguration auf Syntaxfehler:

sudo nginx -t

Wenn keine Fehler gemeldet werden, starten Sie Nginx neu, um die Änderungen anzuwenden:

sudo systemctl restart nginx

Schritt 7. Sichern Sie Gitea mit SSL/TLS.

Um Ihre Gitea-Installation mit SSL/TLS-Zertifikaten zu sichern, installieren Sie Certbot und besorgen Sie sich ein Let’s Encrypt-Zertifikat:

sudo apt install certbot python3-certbot-nginx

Führen Sie Certbot aus, um das SSL/TLS-Zertifikat für Ihre Domäne abzurufen und zu konfigurieren:

sudo certbot --nginx -d your-domain.com

Befolgen Sie die Anweisungen, um eine E-Mail-Adresse anzugeben und den Nutzungsbedingungen von Let’s Encrypt zuzustimmen. Wählen Sie bei entsprechender Aufforderung aus, ob der HTTP-Verkehr auf HTTPS umgeleitet werden soll.

Schritt 8. Greifen Sie auf die Gitea-Weboberfläche zu.

Öffnen Sie einen Webbrowser und navigieren Sie zu Ihrem Domänennamen (z. B. https://your-domain.com). Sie sollten mit der Gitea-Installationsseite begrüßt werden.

Füllen Sie die erforderlichen Informationen aus, wie etwa die Datenbankeinstellungen (die auf Grundlage Ihrer app.ini Konfiguration), Administratorkontodetails und alle anderen relevanten Einstellungen.

Herzlichen Glückwunsch! Sie haben Gitea erfolgreich installiert. Vielen Dank, dass Sie dieses Tutorial zur Installation von Gitea auf dem Ubuntu 24.04 LTS-System verwendet haben. Für weitere Hilfe oder nützliche Informationen empfehlen wir Ihnen, die Gitea-Website.

Schreibe einen Kommentar

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert