Skip to content

Configuring Gitlab

see https://docs.gitlab.com/ee/install/docker.html#configuration

Terminal window
export GITLAB_HOME=/home/gitlab

After changes to the /etc/gitlab/gitlab.rb file run:

Terminal window
docker exec -it gitlab /bin/bash

or directly edit

Terminal window
sudo docker exec -it gitlab editor /etc/gitlab/gitlab.rb
Terminal window
sudo docker exec -it gitlab-ctl reconfigure

Set GitLab’s mail settings in /etc/gitlab/gitlab.rb, then run gitlab-ctl reconfigure. A minimal example for a relay on port 465 with implicit TLS (placeholders):

gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.example.org"
gitlab_rails['smtp_port'] = 465
gitlab_rails['smtp_user_name'] = "smtp-user"
gitlab_rails['smtp_password'] = "smtp-password"
gitlab_rails['smtp_domain'] = "mail.example.org"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_tls'] = true
gitlab_rails['smtp_enable_starttls_auto'] = false
gitlab_rails['smtp_openssl_verify_mode'] = 'peer'
gitlab_rails['gitlab_email_from'] = "gitlab@mail.example.org"

For port 587, set smtp_tls = false and smtp_enable_starttls_auto = true instead. Without SMTP settings the Omnibus image falls back to a sendmail binary it doesn’t ship, and every notification fails quietly. See App and Transactional Email for a worked setup and a health check.

Recent changes

  1. docs(wiki): reorganize the email guides for self-hosters gitayam
  2. refactor(structure): flatten workers into apps/ directory gitayam