SMTP-Server Konfiguration

Verwenden Sie einen externen Mailserver zum Versand Ihrer GitLab E-Mails und konfigurieren Sie diese, um wichtige Benachrichtigungen Ihres GitLab Servers per E-Mail zu empfangen.

Für die erfolgreiche Konfiguration benötigen Sie:

• SMTP-Server / SMTP-Port
• SMTP-Benutzername
• Art der Verschlüsselung (SSL/TLS oder STARTTLS)
• SMTP-Passwort
• Die SMTP-Domain

GitLab Konfigurationsdatei

Um Ihren GitLab Server zu konfigurieren, müssen Sie folgende Schritte ausführen, um die Konfigurationsdatei gitlab.rb erfolgreich für den Versand von E-Mails konfigurieren zu können.

Verbinden Sie sich per SSH als root-Benutzer mit Ihrem GitLab Server und navigieren Sie zur GitLab Konfigurationsdatei. Die gitlab.rb-Datei finden Sie unter /etc/gitlab/gitlab.rb. Mit dem Text-Editor nano, können Sie die Datei öffnen und bearbeiten.

Um die Datei mit nano zu öffnen, führen Sie folgenden Befehl aus:

nano /etc/gitlab/gitlab.rb

Innerhalb der GitLab-Konfiguration können Sie einen SMTP-Server für den E-Mail-Versand konfigurieren. Falls Sie einen eigenen SMTP-Server nutzen, müssen Sie die erforderlichen SMTP-Daten bei Ihrem Hosting/Server Anbieter erfragen. Andernfalls können Sie einen Sendeconnector von uns konfigurieren.

Sendeconnector einrichten

Für das Senden von Transaktions-E-Mails stellen wir dedizierte Sendeconnector bereit, die Sie kostenlos in Ihrem Kundencenter erstellen und nutzen können. Siehe auch: Sendeconnectors

Um den Sendeconnector in Ihrem GitLab Server verwenden zu können, müssen Sie die Konfiguration der zuvor geöffneten gitlab.rb vornehmen.

Suchen Sie in der gitlab.rb nach der Konfiguration der GitLab E-Mail Server Settings.

### GitLab email server settings
###! Docs: https://docs.gitlab.com/omnibus/settings/smtp.html
###! **Use smtp instead of sendmail/postfix.**

# gitlab_rails['smtp_enable'] = true
# gitlab_rails['smtp_address'] = "smtp.server"
# gitlab_rails['smtp_port'] = 465
# gitlab_rails['smtp_user_name'] = "smtp user"
# gitlab_rails['smtp_password'] = "smtp password"
# gitlab_rails['smtp_domain'] = "example.com"
# gitlab_rails['smtp_authentication'] = "login"
# gitlab_rails['smtp_enable_starttls_auto'] = true
# gitlab_rails['smtp_tls'] = false
# gitlab_rails['smtp_pool'] = false

Wichtig für die erfolgreiche Konfiguration des Sendeconnectors in Ihrem GitLab Server sind folgende Zeilen:

gitlab_rails['smtp_address'] = "smtp.server"

Ersetzen Sie “smtp.server” mit der SMTP-Adresse aus dem Kundencenter.

gitlab_rails['smtp_port'] = 465

Ersetzen Sie den Port 465, nur falls Sie STARTTLS nutzen möchten zu 587. Der Port 465 nutzt SSL/TLS.

gitlab_rails['smtp_user_name'] = "smtp user"

Ersetzen Sie “smtp user” mit Ihrem SMTP-Benutzernamen aus dem Kundencenter.

gitlab_rails['smtp_password'] = "smtp password"

Ersetzen Sie “smtp password” mit Ihrem SMTP-Passwort aus dem Kundencenter.

gitlab_rails['smtp_domain'] = "example.com"

Ersetzen Sie “example.com” mit Ihrer SMTP-Domain. Als Beispiel: smtp.meinedomain.de

gitlab_rails['smtp_enable_starttls_auto'] = true
gitlab_rails['smtp_tls'] = false

Ersetzen Sie das von Ihnen genutzte Verfahren von false zu true. Falls Sie Port 465 SSL/TLS nutzen ändern Sie ‘smtp_tls’ zu true. Wenn Sie STARTTLS nutzen, ändern Sie ‘smtp_enable_starttls_auto’ zu true.

Die Absender-E-Mail-Adresse kann mit folgenden Direktiven festgelegt werden.

Um die Absender E-Mail konfigurieren zu können, benötigen Sie noch Anpassungen der folgenden Zeilen:

gitlab_rails['gitlab_email_from'] = 'example@example.com'
gitlab_rails['gitlab_email_display_name'] = 'Example'
gitlab_rails['gitlab_email_reply_to'] = 'noreply@example.com'

gitlab_rails['gitlab_email_from'] = 'example@example.com'

In ‘gitlab_email_from’ können Sie die Absender E-Mail-Adresse einstellen. Als Beispiel: gitlab@meinedomain.de

gitlab_rails['gitlab_email_display_name'] = 'Example'

Unter ‘gitlab_email_display_name’ können Sie den Absendernamen anpassen, der Ihnen angezeigt wird. Als Beispiel nehmen wir hier ‘GitLab’.

gitlab_rails['gitlab_email_reply_to'] = 'noreply@example.com'

In ‘gitlab_email_reply_to’ können Sie anpassen, an welche E-Mail-Adresse mögliche Antworten gesendet werden sollen.

Um die Änderungen auf Ihrem GitLab Server anzuwenden, folgen Sie diesem Hilfecenter Artikel zu Änderungen anwenden.

Externer SMTP-Server einrichten

Wenn Sie einen externen SMTP-Server verwenden möchten, müssen Ihnen die Daten wie Server, Benutzername, Passwort vorliegen. Wenn Sie die Daten haben, können Sie mit der Anleitung fortfahren.

Suchen Sie in der gitlab.rb nach der Konfiguration der GitLab E-Mail Server Settings.

### GitLab email server settings
###! Docs: https://docs.gitlab.com/omnibus/settings/smtp.html
###! **Use smtp instead of sendmail/postfix.**

# gitlab_rails['smtp_enable'] = true
# gitlab_rails['smtp_address'] = "smtp.server"
# gitlab_rails['smtp_port'] = 465
# gitlab_rails['smtp_user_name'] = "smtp user"
# gitlab_rails['smtp_password'] = "smtp password"
# gitlab_rails['smtp_domain'] = "example.com"
# gitlab_rails['smtp_authentication'] = "login"
# gitlab_rails['smtp_enable_starttls_auto'] = true
# gitlab_rails['smtp_tls'] = false
# gitlab_rails['smtp_pool'] = false

Wichtig für die erfolgreiche Konfiguration des externen SMTP-Servers in Ihrem GitLab Server sind folgende Zeilen:

gitlab_rails['smtp_address'] = "smtp.server"

Ersetzen Sie “smtp.server” mit der SMTP-Adresse von Ihrem Anbieter.

gitlab_rails['smtp_port'] = 465

Ersetzen Sie den Port 465, nur falls Sie STARTTLS nutzen möchten zu 587. Der Port 465 nutzt SSL/TLS. Die hier aufgeführten Ports könnten bei Ihrem Anbieter abweichen, bitte prüfen Sie die Ports.

gitlab_rails['smtp_user_name'] = "smtp user"

Ersetzen Sie “smtp user” mit Ihrem SMTP-Benutzernamen von Ihrem Anbieter.

gitlab_rails['smtp_password'] = "smtp password"

Ersetzen Sie “smtp password” mit Ihrem SMTP-Passwort von Ihrem Anbieter.

gitlab_rails['smtp_domain'] = "example.com"

Ersetzen Sie “example.com” mit Ihrer SMTP-Domain. Als Beispiel: smtp.meinedomain.de

gitlab_rails['smtp_enable_starttls_auto'] = true
gitlab_rails['smtp_tls'] = false

Ersetzen Sie das von Ihnen genutzte Verfahren von false zu true. Falls Sie Port 465 SSL/TLS nutzen ändern Sie ‘smtp_tls’ zu true. Wenn Sie STARTTLS nutzen, ändern Sie ‘smtp_enable_starttls_auto’ zu true.

Um die Absender E-Mail konfigurieren zu können, benötigen Sie noch Anpassungen der folgenden Zeilen:

gitlab_rails['gitlab_email_from'] = 'example@example.com'
gitlab_rails['gitlab_email_display_name'] = 'Example'
gitlab_rails['gitlab_email_reply_to'] = 'noreply@example.com'

gitlab_rails['gitlab_email_from'] = 'example@example.com'

In ‘gitlab_email_from’ können Sie die Absender E-Mail-Adresse einstellen. Als Beispiel: gitlab@meinedomain.de

gitlab_rails['gitlab_email_display_name'] = 'Example'

Unter ‘gitlab_email_display_name’ können Sie den Absendernamen anpassen, der Ihnen angezeigt wird. Als Beispiel nehmen wir hier ‘GitLab’.

gitlab_rails['gitlab_email_reply_to'] = 'noreply@example.com'

In ‘gitlab_email_reply_to’ können Sie anpassen, an welche E-Mail-Adresse mögliche Antworten gesendet werden sollen.

Um die Änderungen auf Ihrem GitLab Server anzuwenden, folgen Sie diesem Hilfecenter Artikel zu Änderungen anwenden.

Änderungen anwenden

Um die Änderungen auf Ihrem GitLab Server anzuwenden, speichern Sie Ihre Konfigurationsdatei und verlassen den Text-Editor und führen den folgenden Befehl aus:

gitlab-ctl reconfigure

Die SMTP-Server Konfiguration testen

Um den E-Mail-Versand Ihres GitLab Servers zu testen, können Sie in die GitLab Rails Console starten mit:

gitlab-rails console

Dort können Sie eine Test-E-Mail mit folgendem Befehl versenden:

Notify.test_email('destination_email@address.com', 'Message Subject', 'Message Body').deliver_now

Bekannte Fehlermeldungen