Tipp: Du kannst für alle Dateinamen und Verzeichnisse die automatische Vervollständigung mithilfe der Tab-Taste nutzen, sodass du nicht die kompletten Datei- oder Verzeichnisnamen manuell eintippen musst.

Diese Anleitung wurde am 10.03.2019 zuletzt überprüft und aktualisiert.

Bist du auf der Suche nach sehr guten, leistungsstarken und günstigen Servern?
Ich miete meine Server seit 5 Jahren bei Contabo und kann Contabo wirklich sehr empfehlen!
  1. Falls du es noch nicht getan hast, lade das Programm "PuTTY" herunter.
  2. Verbinde dich mithilfe von PuTTY via SSH mit deinem Root- oder vServer. Hierfür öffnest du PuTTY und gibst im Textfeld "Host Name (or IP address)" die Domain oder IP-Adresse deines Servers ein. Klicke anschließend unten auf "OK".
  3. Aktualisiere nun deine Paketlisten mit dem Befehl apt update.
  4. Installiere jetzt möglicherweise verfügbare Updates der auf deinem Server bereits installieren Pakete mit dem Befehl apt upgrade -y.
  5. Als nächstes installierst du Pakete, die für die weiteren Installationen benötigt werden, mit folgendem Befehl: apt install curl nano ca-certificates -y
  6. Wenn du für den Versand von E-Mails, u.a. für die Aktivierung neuer Benutzer, einen eigenen Mailserver (SMTP) verwenden möchtest, dann empfehle ich dir den Mailcow-Mailserver. Hierzu habe ich auch eine Anleitung veröffentlicht. Alternativ kannst du auch Postfix verwenden, Mailcow ist jedoch eher zu empfehlen. Falls du Postfix installieren möchtest, verwende den Befehl apt install postfix -y, wähle während der Installation "Internet-Site" aus und gib deine Domain als "System-E-Mail-Name" an. Falls du einen externen SMTP-Server - beispielsweise Gmail, Mailgun etc. - oder Mailcow für den Versand der E-Mails aus GitLab nutzen möchtest, überspringe diesen Schritt und führe nach der GitLab-Installation stattdessen den Schritt 10 dieser Anleitung durch (SMTP-Konfiguration).
  7. Füge mit dem Befehl curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.deb.sh | bash die für die Installation von GitLab benötigte Paketquelle hinzu.
  8. Gib nun den Befehl apt update ein, um deine Paketlisten erneut zu aktualisieren.
  9. Installiere anschließend GitLab sowie weitere benötigte Pakete mithilfe des folgenden Befehls: EXTERNAL_URL="http://gitlab.domain.de" apt install gitlab-ee -y. Ersetze dabei "http://gitlab.domain.de" durch die URL, unter der GitLab später erreichbar sein soll. Dies ist u.a. für Verlinkungen innerhalb von GitLab wichtig. Hinweis: Es wird der standardmäßige Webserver-Port 80 verwendet. Ist bereits ein Webserver wie z.B. Apache2 installiert, dann musst du einen anderen Port wählen. Gib den gewünschten Port in diesem Fall einfach hinter der URL mit an (z.B. "http://gitlab.domain.de:8888" für Port 8888).
  10. Optional (falls du Mailcow oder einen externen SMTP-Server für den E-Mail Versand verwenden möchtest) :
    1. Öffne die Konfigurationsdatei von GitLab mit dem Befehl nano /etc/gitlab/gitlab.rb
    2. Gehe in dieser Datei zum Bereich der SMTP-Konfiguration ab Zeile 508 und entferne jeweils das "#"-Zeichen vor den Zeilen 508 bis einschließlich 516. Passe daraufhin die SMTP-Konfiguration entsprechend deines SMTP-Servers an. Einige Informationen dazu, darunter auch die SMTP-Konfiguration für Mailcow, findest du hier.
    3. Speichere deine Änderungen der Konfiguration, indem du STRG + X, danach die "Y"-Taste und anschließend Enter drückst.
    4. Generiere nun die GitLab-Konfiguration mithilfe des Befehls gitlab-ctl reconfigure neu und führe einen Neustart von GitLab aus, indem du den Befehl gitlab-ctl restart verwendest.
  11. Rufe als nächstes deine GitLab-Installation im Browser unter der von dir gewählten URL auf und setze auf der rechten Seite ein Passwort für den Administrator-Benutzer. Der Benutzername lautet automatisch "root".
  12. Nun kannst du dich mit dem Benutzernamen "root" und deinem soeben gesetzten Passwort einloggen und GitLab nach Belieben konfigurieren und nutzen.
  13. Diverse weitere Konfigurationsparameter sind in der Datei "/etc/gitlab/gitlab.rb" zu finden. Möchtest du beispielsweise die URL deiner GitLab-Installation ändern, dann öffne diese Datei durch die Eingabe des Befehls nano /etc/gitlab/gitlab.rb und passe den entsprechenden Wert des Parameters "EXTERNAL_URL" in Zeile 13 an. Speichere deine Änderungen der Konfiguration, indem du STRG + X, danach die "Y"-Taste und anschließend Enter drückst und generiere die Konfiguration mit dem Befehl gitlab-ctl reconfigure neu. Starte GitLab daraufhin mithilfe des folgenden Befehls noch einmal neu: gitlab-ctl restart