Setup GitLab Outgoing Emails

Startup

Run in a docker container... add the following to the docker-compose YAML in setup.md.

This example uses MailGun... don't try to use Google / G Suite, it's painful and rarely works.

    ...
        environment:
            GITLAB_OMNIBUS_CONFIG: |
                ...

                gitlab_rails['smtp_enable'] = true
                gitlab_rails['smtp_domain'] = 'mailgun.example.com'
                gitlab_rails['smtp_address'] = 'smtp.mailgun.org'
                gitlab_rails['smtp_port'] = 465
                gitlab_rails['smtp_tls'] = true
                gitlab_rails['smtp_enable_starttls_auto'] = false
                gitlab_rails['smtp_authentication'] = 'login'
                gitlab_rails['smtp_user_name'] = 'gitlab@mailgun.example.com'
                gitlab_rails['smtp_password'] = 'XXX'

                ...

    ...

Test

docker exec -it ${CONTAINER} gitlab-rails console
Notify.test_email('${RECIPIENT_EMAIL}', 'TEST FROM GITLAB', 'HELLO').deliver_now