GitLab auf einem Linux Server einrichten – Hoste deine eigene DevOps Plattform

Entdecke, wie du GitLab effizient auf Linux installierst, um DevOps-Workflows zu optimieren und die Teamarbeit zu verbessern → Jetzt mehr erfahren

5. November 20266 Min. Lesezeit0 Aufrufe0 hilfreich

Einführung

GitLab ist eine umfassende DevOps-Plattform, die Teams ermöglicht, gemeinsam am Code zu arbeiten, Workflows zu automatisieren und den gesamten Softwareentwicklungszyklus effizient zu managen. In dieser Anleitung erklären wir, wie du GitLab auf einem Linux Server installierst.

GitLab mit One-Click Apps installieren

Du kannst GitLab direkt über One-Click Apps im vServer Webinterface installieren. Nach der ersten Einrichtung der Apps öffnest du den App-Katalog, suchst nach GitLab und startest die Bereitstellung mit deinen bevorzugten Projekt-, Umgebungs- und Domain-Einstellungen. So kannst du GitLab schnell und benutzerfreundlich deployen und verwalten, ohne manuelle Kommandozeilen-Setups, und profitierst trotzdem von integrierter webbasierter Verwaltung, Support für eigene Domains und SSL-Bereitstellung, wo verfügbar.

Vorbereitung

Die folgenden Anforderungen werden vom offiziellen GitLab Team empfohlen. Es ist sehr ratsam, die Voraussetzungen einzuhalten, um spätere Probleme und Unannehmlichkeiten zu vermeiden.

Hardware

Komponenten	Minimum	Empfohlen
CPU	2x 2 GHz	4x 2,6+ GHz
RAM	4 GB	8 GB
Speicher	10 GB	50+ GB
Bandbreite	100 Mbit/s (Up & Down)	100 Mbit/s (Up & Down)

Software

Plattform	Optionen
Betriebssystem	Ubuntu (20.04, 22.04, 24.04), Debian (10, 11, 12), OpenSUSE (15.5)
Datenbank	PostgreSQL 14.9+
Webserver	NGINX (mit GitLab gebündelt), Puma 6.4.2+
Sonstiges	Redis 7.x+, Sidekiq 7.3.2+, Prometheus 2.54.1+

Info

Für die aktuellsten und genauesten Spezifikationen schau bitte in die offizielle Hardware Requirements Dokumentation von GitLab.

Um GitLab auf deinem Linux Server zu installieren, musst du dich per SSH-Client verbinden. Schau dir dazu unsere Erstzugriff (SSH) Anleitung an.

Sobald die Verbindung steht, kannst du die notwendigen Pakete installieren, die für die GitLab-Installation gebraucht werden.

Schritt 1: Abhängigkeiten installieren

Zuerst musst du einige Abhängigkeiten installieren, damit der GitLab Installer läuft. Nutze die folgenden Befehle, um die benötigten Pakete auf deinem Linux Server zu installieren.

Aktualisiere die Paketliste und installiere den OpenSSH Server sowie die benötigten Voraussetzungen mit folgendem Befehl. So wird dein Webinterface für GitLab gehostet.

Code

sudo apt update
sudo apt-get install -y curl openssh-server ca-certificates tzdata perl

Optional kannst du Postfix (SMTP Server) installieren, wenn du E-Mail-Benachrichtigungen über GitLab versenden möchtest.

Falls du E-Mail-Benachrichtigungen nutzen willst, installiere Postfix mit:

Code

sudo apt-get install -y postfix

Aktualisiere die Paketliste und installiere den OpenSSH Server sowie die benötigten Voraussetzungen mit folgendem Befehl. So wird dein Webinterface für GitLab gehostet.

Code

sudo apt update
sudo apt-get install -y curl openssh-server ca-certificates perl

Optional kannst du Postfix (SMTP Server) installieren, wenn du E-Mail-Benachrichtigungen über GitLab versenden möchtest.

Falls du E-Mail-Benachrichtigungen nutzen willst, installiere Postfix mit:

Code

sudo apt-get install -y postfix

Installiere den OpenSSH Server sowie die benötigten Voraussetzungen mit folgendem Befehl. So wird dein Webinterface für GitLab gehostet.

Code

sudo zypper install curl openssh perl

Stelle sicher, dass der OpenSSH-Daemon aktiviert ist:

Code

sudo systemctl status sshd
sudo systemctl enable sshd
sudo systemctl start sshd

Falls du firewalld nutzt, stelle sicher, dass die nötigen Ports freigegeben sind.

Prüfe, ob firewalld aktiv ist mit:

bash

sudo systemctl status firewalld

Falls ja, öffne die Standard-Ports (80 und 443):

Code

sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo systemctl reload firewalld

Optional kannst du Postfix (SMTP Server) installieren, wenn du E-Mail-Benachrichtigungen über GitLab versenden möchtest.

Falls du E-Mail-Benachrichtigungen nutzen willst, installiere Postfix mit:

Code

sudo zypper install postfix
sudo systemctl enable postfix
sudo systemctl start postfix

Info

Während der Postfix-Installation kann eine Konfiguration erscheinen. Wähle hier „Internet Site“ und bestätige mit Enter. Gib als „mail name“ die externe DNS deines Linux Servers ein und bestätige. Falls weitere Bildschirme erscheinen, bestätige jeweils mit Enter, um die Standardwerte zu übernehmen. Wenn du eine andere Lösung für den E-Mail-Versand nutzen möchtest, überspringe diesen Schritt und konfiguriere einen externen SMTP-Server nach der GitLab-Installation anhand der offiziellen Anleitung.

Schritt 2: GitLab installieren

Nachdem alle Abhängigkeiten installiert sind, kannst du GitLab installieren.

In dieser Anleitung installieren wir GitLab direkt aus den offiziellen Paket-Repositories.

Das folgende Skript fügt die GitLab-Repositories zum apt Paketmanager hinzu:

Code

curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.deb.sh | sudo bash

Danach kannst du das Paket gitlab-ee installieren:

bash

sudo apt-get install -y gitlab-ee

Das folgende Skript fügt die GitLab-Repositories zum Zypper Paketmanager hinzu:

Code

curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.rpm.sh | sudo bash

Danach kannst du das Paket gitlab-ee installieren:

bash

sudo zypper install gitlab-ee

Nach Abschluss dieses Prozesses sollte GitLab auf deinem Linux Server einsatzbereit sein. Im nächsten Abschnitt konfigurierst du wichtige Einstellungen, damit der Server reibungslos läuft.

Schritt 3: GitLab konfigurieren

Damit alles funktioniert, musst du einige Änderungen an der Konfigurationsdatei vornehmen. Öffne die GitLab-Konfigurationsdatei mit deinem bevorzugten Texteditor. Wir nutzen hier als Beispiel den vorinstallierten nano Editor.

Code

sudo nano /etc/gitlab/gitlab.rb

Suche die Zeile external_url und trage entweder deine Domain oder die IP-Adresse deines Linux Servers ein, falls du keine Domain für GitLab verwenden möchtest.

Code

## GitLab URL
##! URL, unter der GitLab erreichbar sein wird.
##! Für mehr Details zur Konfiguration von external_url siehe:
##! https://docs.gitlab.com/omnibus/settings/configuration.html#configuring-the-external-url-for-gitlab
##!
##! Hinweis: Während Installation/Updates wird der Wert der Umgebungsvariable
##! EXTERNAL_URL genutzt, um diesen Wert zu setzen/ersetzen.
##! Bei AWS EC2 Instanzen wird versucht, den öffentlichen Hostnamen/IP
##! von AWS abzurufen. Mehr Infos:
##! https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-data-retrieval.html
external_url 'http`s`://`Deine Domain / IPv4-Adresse deines Linux Servers`'

Wir empfehlen außerdem, deine E-Mail-Adresse in der Zeile letsencrypt['contact_emails'] einzutragen. So kann Let's Encrypt dich über automatische und kostenlose SSL-Zertifikate informieren und kontaktieren.

Info

Für ein kostenloses SSL-Zertifikat von Let's Encrypt benötigst du eine Domain. Ein Zertifikat direkt für eine IP-Adresse kannst du nicht anfordern.

Code

################################################################################
# Let's Encrypt Integration
################################################################################
# letsencrypt['enable'] = nil
# letsencrypt['contact_emails'] = [`Deine E-Mail hier`] # Das sollte ein Array von E-Mail-Adressen sein
# letsencrypt['group'] = 'root'
# letsencrypt['key_size'] = 2048
# letsencrypt['owner'] = 'root'
# letsencrypt['wwwroot'] = '/var/opt/gitlab/nginx/www'
# Siehe https://docs.gitlab.com/omnibus/settings/ssl/index.html#renew-the-certificates-automatically für mehr Infos
# letsencrypt['auto_renew'] = true
# letsencrypt['auto_renew_hour'] = 0
# letsencrypt['auto_renew_minute'] = nil # Sollte eine Zahl oder Cron-Ausdruck sein, falls angegeben.
# letsencrypt['auto_renew_day_of_month'] = "*/4"
# letsencrypt['auto_renew_log_directory'] = '/var/log/gitlab/lets-encrypt'
# letsencrypt['alt_names'] = []

Tipp

Du kannst CTRL+W drücken, um nach letsencrypt['contact_emails'] zu suchen und Enter drücken, damit du nicht die ganze Datei manuell durchsuchen musst.

Wenn du fertig bist, drücke CTRL+X, dann Y und Enter, um die Änderungen zu speichern.

Führe abschließend den folgenden Befehl aus, um GitLab mit den neuen Einstellungen neu zu konfigurieren:

Code

sudo gitlab-ctl reconfigure

Dieser Vorgang kann eine Weile dauern, da GitLab mit den aktualisierten Konfigurationsdaten initialisiert wird. Falls eine Domain verwendet wurde, werden auch die SSL-Zertifikate automatisch ausgestellt.

Schritt 4: Zugriff auf das Webinterface

Nach der Initialisierung sollte der Server nun über einen Webbrowser erreichbar sein. Rufe deine Seite auf, indem du deine Domain oder IP-Adresse eingibst:

Code

https://[deine_domain] ODER http://[deine_ip_adresse]

Beim ersten Zugriff erscheint die Login-Seite.

Für den ersten Login nutzt du den Benutzer root.

Das Passwort findest du in einer Datei auf deinem Linux Server. Öffne die Datei mit folgendem Befehl und suche das Feld Password:

Code

sudo nano /etc/gitlab/initial_root_password

Code

# WARNUNG: Dieser Wert ist nur gültig unter folgenden Bedingungen

# 1. Wenn er manuell gesetzt wurde (entweder via `GITLAB_ROOT_PASSWORD` Umgebungsvariable oder `gitlab_rails['initial_root_password']` Einstellung in `gitlab.rb` vor der ersten Datenbankbefüllung).

# 2. Das Passwort wurde nicht manuell geändert, weder über UI noch Kommandozeile.

#

# Falls das hier angezeigte Passwort nicht funktioniert, musst du das Admin-Passwort zurücksetzen: https://docs.gitlab.com/ee/security/reset_user_password.html#reset-your-root-password.

Password: `[DEIN_PASSWORT_HIER]`

# HINWEIS: Diese Datei wird automatisch beim ersten Reconfigure-Lauf nach 24 Stunden gelöscht.

Gib Benutzername und Passwort auf der Login-Seite ein, um dein GitLab Dashboard zum ersten Mal zu betreten. Du solltest jetzt Zugriff auf dein GitLab Panel auf deinem eigenen Linux Server haben.

Wir empfehlen dringend, einen neuen Benutzer anzulegen und/oder das Passwort des root Users zu ändern. Das kannst du über Admin unten links und dann Übersicht -> Benutzer machen. Dort kannst du alle Nutzer deiner GitLab-Instanz verwalten.

Optional: Firewall mit ufw einrichten

Diesen Schritt kannst du überspringen, wenn du keine Firewall konfigurieren möchtest oder z.B. bereits firewalld auf OpenSUSE nutzt. Stelle sicher, dass die Ports 80/443 und 22 freigegeben sind.

ufw installieren

Falls ufw bereits installiert ist, kannst du diesen Schritt überspringen.

bash

sudo apt-get install -y ufw

bash

sudo zypper install ufw

Benötigte Ports öffnen

Code

sudo ufw allow http
sudo ufw allow https
sudo ufw allow OpenSSH

Firewall aktivieren

Achtung

Standardmäßig blockiert ufw dann alle anderen Ports außer den erlaubten. Stelle sicher, dass deine Whitelist korrekt ist, bevor du diesen Befehl ausführst.

Aktiviere die Firewall mit:

Code

sudo ufw enable

Fazit

Glückwunsch, du hast GitLab erfolgreich installiert! Falls du noch Fragen oder Probleme hast, steht dir unser Support-Team täglich zur Verfügung und hilft dir gerne weiter!

Wenn du weitere Einstellungen vornehmen möchtest, empfehlen wir dir, die offizielle GitLab Dokumentation für die nächsten Schritte zu lesen.

FAQ

Häufig gestellte Fragen

Du kannst GitLab direkt über One-Click Apps im vServer-Webinterface installieren, indem du im App-Katalog nach GitLab suchst und die Bereitstellung mit deinen bevorzugten Projekt-, Umgebungs- und Domain-Einstellungen startest.

Minimum sind 2x 2 GHz CPU, 4 GB RAM, 10 GB Speicher und 100 Mbit/s Bandbreite (Up & Down). Empfohlen werden 4x 2,6+ GHz CPU, 8 GB RAM und 50+ GB Speicher.

GitLab ist eine umfassende DevOps-Plattform, die Teams ermöglicht, gemeinsam am Code zu arbeiten, Workflows zu automatisieren und den gesamten Softwareentwicklungszyklus effizient zu managen.

Feedback

War dieser Artikel hilfreich?

Deine Rückmeldung hilft uns, Inhalte besser zu priorisieren und zu überarbeiten.

0 von 0 Rückmeldungen fanden diesen Artikel hilfreich.

Persönliche Hilfe

Die Anleitung reicht nicht?

Unser ZAP-Support kennt dein Produkt — beschreib kurz dein Anliegen und wir helfen dir persönlich weiter.

## GitLab URL ##! URL, unter der GitLab erreichbar sein wird. ##! Für mehr Details zur Konfiguration von external_url siehe: ##! https://docs.gitlab.com/omnibus/settings/configuration.html#configuring-the-external-url-for-gitlab ##! ##! Hinweis: Während Installation/Updates wird der Wert der Umgebungsvariable ##! EXTERNAL_URL genutzt, um diesen Wert zu setzen/ersetzen. ##! Bei AWS EC2 Instanzen wird versucht, den öffentlichen Hostnamen/IP ##! von AWS abzurufen. Mehr Infos: ##! https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-data-retrieval.html external_url 'http`s`://`Deine Domain / IPv4-Adresse deines Linux Servers`'

################################################################################ # Let's Encrypt Integration ################################################################################ # letsencrypt['enable'] = nil # letsencrypt['contact_emails'] = [`Deine E-Mail hier`] # Das sollte ein Array von E-Mail-Adressen sein # letsencrypt['group'] = 'root' # letsencrypt['key_size'] = 2048 # letsencrypt['owner'] = 'root' # letsencrypt['wwwroot'] = '/var/opt/gitlab/nginx/www' # Siehe https://docs.gitlab.com/omnibus/settings/ssl/index.html#renew-the-certificates-automatically für mehr Infos # letsencrypt['auto_renew'] = true # letsencrypt['auto_renew_hour'] = 0 # letsencrypt['auto_renew_minute'] = nil # Sollte eine Zahl oder Cron-Ausdruck sein, falls angegeben. # letsencrypt['auto_renew_day_of_month'] = "*/4" # letsencrypt['auto_renew_log_directory'] = '/var/log/gitlab/lets-encrypt' # letsencrypt['alt_names'] = []

Welche 🍪 Cookies dürfen es für dich sein?

GitLab auf einem Linux Server einrichten – Hoste deine eigene DevOps Plattform

Einführung

GitLab mit One-Click Apps installieren

Vorbereitung

Hardware

Software

Schritt 1: Abhängigkeiten installieren

Schritt 2: GitLab installieren

Schritt 3: GitLab konfigurieren

Schritt 4: Zugriff auf das Webinterface

Optional: Firewall mit ufw einrichten

ufw installieren

Benötigte Ports öffnen

Firewall aktivieren

Fazit

Häufig gestellte Fragen

Software

GitLab mit One-Click Apps installieren

Schritt 1: Abhängigkeiten installieren

Schritt 2: GitLab installieren

Schritt 3: GitLab konfigurieren

Schritt 4: Zugriff auf das Webinterface

Optional: Firewall mit ufw einrichten

ufw installieren

Benötigte Ports öffnen

Firewall aktivieren

Fazit

Gameserver

Server & Hosting

ZAPX

Ressourcen

ZAP-Hosting