Configuring Gitlab
Configuring Gitlab
Section titled “Configuring Gitlab”see https://docs.gitlab.com/ee/install/docker.html#configuration
export GITLAB_HOME=/home/gitlabReconfigure Commands
Section titled “Reconfigure Commands”After changes to the /etc/gitlab/gitlab.rb file run:
docker exec -it gitlab /bin/bashor directly edit
sudo docker exec -it gitlab editor /etc/gitlab/gitlab.rbsudo docker exec -it gitlab-ctl reconfigureEmail (SMTP)
Section titled “Email (SMTP)”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'] = truegitlab_rails['smtp_address'] = "smtp.example.org"gitlab_rails['smtp_port'] = 465gitlab_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'] = truegitlab_rails['smtp_enable_starttls_auto'] = falsegitlab_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.