GitLab18.3サーバにメールサーバーを設定してメール送信する手順

・GitLab18.3サーバにメールサーバーを設定してメール送信ができるようにしたい。
・具体的な設定方法を教えてほしい。

こういった疑問に答えます。

本記事の内容

1. GitLab18.3サーバにメールサーバーを設定してメール送信する手順

サトナカ (@souiunogaii)

この記事を書いている私は、某SIerに勤務しながら、
WEB系エンジニア・インフラエンジニアに憧れて、プログラミングおよびインフラ技術の勉強をしています。

こういった私が、解説していきます。

私が実機で試したコマンドや画像を載せて書いています。
記事の信頼性担保に繋がると思います。

GitLab18.3サーバにメールサーバーを設定してメール送信する手順

/etc/gitlab/gitlab.rb

[root@a-gitlb01 ~]# cp -p /etc/gitlab/gitlab.rb /etc/gitlab/gitlab.rb_original
[root@a-gitlb01 ~]# vi /etc/gitlab/gitlab.rb

     96 ### GitLab email server settings
     97 ###! Docs: https://docs.gitlab.com/omnibus/settings/smtp.html
     98 ###! **Use smtp instead of sendmail/postfix.**
     99
    100 # gitlab_rails['smtp_enable'] = true
    101 # gitlab_rails['smtp_address'] = "a-email01.blue-planet.internal"
    102 # gitlab_rails['smtp_port'] = 587
    103 # gitlab_rails['smtp_user_name'] = "★★★ユーザ名"
    104 # gitlab_rails['smtp_password'] = "★★★パスワード"
    105 # gitlab_rails['smtp_domain'] = "blue-planet.internal"
    106 # gitlab_rails['smtp_authentication'] = "login"
    107 # gitlab_rails['smtp_enable_starttls_auto'] = false
    108 # gitlab_rails['smtp_tls'] = false
    109 # gitlab_rails['smtp_pool'] = false

再構築

gitlab-ctl reconfigure

[root@a-gitlb01 ~]# gitlab-ctl reconfigure
[2025-09-03T15:23:33+09:00] INFO: Started Cinc Zero at chefzero://localhost:1 with repository at /opt/gitlab/embedded (One version per cookbook)
Cinc Client, version 18.3.0
Patents: https://www.chef.io/patents
Infra Phase starting
　
　　(中略)
　
Running handlers:
[2025-09-03T15:23:46+09:00] INFO: Running report handlers
Running handlers complete
[2025-09-03T15:23:46+09:00] INFO: Report handlers complete
Infra Phase complete, 3/841 resources updated in 12 seconds
gitlab Reconfigured!

サービス再起動

gitlab-ctl restart

[root@a-gitlb01 ~]# gitlab-ctl restart
ok: run: alertmanager: (pid 27243) 1s
ok: run: gitaly: (pid 27250) 0s
ok: run: gitlab-exporter: (pid 27266) 0s
ok: run: gitlab-kas: (pid 27270) 1s
ok: run: gitlab-workhorse: (pid 27281) 0s
ok: run: logrotate: (pid 27292) 1s
ok: run: nginx: (pid 27298) 0s
ok: run: node-exporter: (pid 27303) 0s
ok: run: postgres-exporter: (pid 27310) 1s
ok: run: postgresql: (pid 27318) 0s
ok: run: prometheus: (pid 27326) 1s
ok: run: puma: (pid 27337) 0s
ok: run: redis: (pid 27342) 0s
ok: run: redis-exporter: (pid 27349) 1s
ok: run: sidekiq: (pid 27356) 0s