GitLab mit Docker installieren

Diese Anleitung zeigt, wie Sie eine selbst gehostete GitLab-CE-Instanz mit dem offiziellen Docker-Image und Docker Compose auf Ihrem Linux-Server betreiben. GitLab vereint Git-Repositories, CI/CD-Pipelines und Issue-Tracking in einer Plattform.

Hohe Systemanforderungen: GitLab ist eine ressourcenintensive Anwendung. Wir empfehlen einen Server mit mindestens 4 CPU-Kernen und 8 GB RAM für einen stabilen Betrieb.

Schritt 1: Docker Compose-Datei erstellen

Melden Sie sich per SSH auf Ihrem Server an, erstellen Sie ein Verzeichnis für GitLab und öffnen Sie die Compose-Datei:

Verzeichnis und Datei erstellen

mkdir gitlab && cd gitlab && nano docker-compose.yml

Fügen Sie folgende Konfiguration in die Datei ein. Die Domain passen Sie im nächsten Schritt an.

docker-compose.yml

services: web: image: 'gitlab/gitlab-ce:latest' restart: always hostname: 'gitlab.example.com' environment: GITLAB_OMNIBUS_CONFIG: | external_url 'https://gitlab.example.com' ports: - '80:80' - '443:443' - '2222:22' volumes: - '$GITLAB_HOME/config:/etc/gitlab' - '$GITLAB_HOME/logs:/var/log/gitlab' - '$GITLAB_HOME/data:/var/opt/gitlab' shm_size: '256m'

Schritt 2: Domain konfigurieren

Ersetzen Sie alle Vorkommen von gitlab.example.com in der Compose-Datei durch Ihre tatsächliche Domain (z. B. gitlab.ihredomain.de). Stellen Sie außerdem sicher, dass der DNS-A-Eintrag Ihrer Domain auf die IP-Adresse Ihres Servers zeigt.

Setzen Sie außerdem die Umgebungsvariable $GITLAB_HOME, die festlegt, wo GitLab seine Daten speichert. Führen Sie folgenden Befehl im selben Verzeichnis wie die Compose-Datei aus:

GITLAB_HOME Variable setzen

export GITLAB_HOME=$(pwd)

Um den Wert nach einem Neustart zu erhalten, fügen Sie die Zeile in Ihre ~/.bashrc oder ~/.profile ein.

Schritt 3: GitLab starten

Starten Sie die GitLab-Instanz mit folgendem Befehl:

Docker Compose starten

docker compose up -d

Bitte Geduld: Beim ersten Start muss GitLab sich initialisieren und konfigurieren. Dieser Vorgang kann 5 bis 15 Minuten oder länger dauern. Die Instanz ist erst erreichbar, wenn dieser Prozess abgeschlossen ist. Den Status können Sie mit docker ps überprüfen.

Schritt 4: Initiales Root-Passwort auslesen

GitLab generiert automatisch ein sicheres Passwort für das initiale root-Administratorkonto. Sobald der Container bereit ist, lesen Sie es mit folgendem Befehl aus:

Root-Passwort auslesen

docker compose exec -T web grep 'Password:' /etc/gitlab/initial_root_password > initial_password.txt

Das Passwort können Sie mit cat initial_password.txt anzeigen. Speichern Sie es an einem sicheren Ort und löschen Sie die Datei anschließend — sie wird nach 24 Stunden automatisch entfernt.

Schritt 5: Erster Login

Öffnen Sie Ihren Browser und navigieren Sie zur konfigurierten Domain (z. B. https://gitlab.ihredomain.de). Melden Sie sich mit folgenden Zugangsdaten an:

Feld	Wert
Benutzername	root
Passwort	Das in Schritt 4 ausgelesene Passwort

Ändern Sie das Root-Passwort unmittelbar nach dem ersten Login in den Profileinstellungen.

Weiterführende Dokumentation

Für erweiterte Konfiguration, CI/CD-Setup und Administrations-Guides empfehlen wir die offizielle GitLab-Dokumentation.

GitLab Docker Docs

GitLab Admin-Dokumentation