Redmine에서 이메일 알림 활성화 설정 방법

Redmine은 기본적으로 이메일 알림 기능을 제공합니다. 하지만 이를 사용하려면 메일 서버 설정을 추가해야 합니다. 이번 섹션에서는 "이메일 알림을 활성화하기 위한 설정 방법"을 자세히 설명하겠습니다.

`~/redmine-5.0/config` 폴더는 Redmine의 주요 설정 파일들이 위치하는 디렉터리입니다.

이곳에는 데이터베이스 연결을 설정하는 `database.yml`, 이메일 알림을 구성하는 `configuration.yml`, 그리고 Redmine의 동작을 조정하는 다양한 환경 설정 파일들이 포함되어 있습니다. Redmine을 정상적으로 실행하려면 이 폴더 내의 설정을 적절히 수정해야 합니다.

이메일 알림을 설정하려면 `configuration.yml.example` 파일을 참고하여 `configuration.yml`을 생성해야 합니다. 하지만 모든 내용을 이해하고 직접 구성하려면 많은 시간이 소요될 수 있습니다. 따라서, 바로 적용할 수 있도록 `configuration.yml`에 입력할 내용을 제공하겠습니다.

제가 사용하는 방법은 두 가지로, Gmail SMTP를 이용하는 방법과 별도의 SMTP 서버를 사용하는 방법입니다.

먼저 Gmail SMTP 설정입니다.

production:
    email_delivery:
        delivery_method: :smtp
        smtp_settings:
            enable_starttls_auto: true
            address: "smtp.gmail.com"
            port: 587
            domain: "smtp.gmail.com"
            authentication: :plain
            user_name: "username@gmail.com"  # SMTP 서버로 사용할 Gmail 계정
            password: "XXXX XXXX XXXX XXXX"  # Google 웹 비밀번호

여기서 아마 궁금하신 부분은 password의 내용입니다. 

먼저 https://myaccount.google.com/ 에 접속합니다.

왼쪽 메뉴에서 `보안` → `2단계 인증`을 클릭한 뒤, 아래로 스크롤하면 `앱 비밀번호` 항목을 확인할 수 있습니다.

처음 접속하신 경우, 앱 비밀번호가 `0개` 또는 `없음`으로 표시될 수 있습니다.

저는 이미 2개의 앱 비밀번호를 생성해 놓은 상태라 아래와 같이 표시됩니다.

오른쪽 화살표(>)를 클릭합니다.

저는 `웹 이름`을 `email_notification` 으로 설정하였으며, `만들기`를 누르시면 새로운 앱 비밀번호가 생성됩니다.

아마 16자리의 앱 비밀번호가 생성되었을 겁니다. 이 비밀번호는 분실 시 다시 확인할 수 없기 때문에, 안전한 곳에 저장해 두시는 것을 추천드립니다.
예를 들어, 생성된 비밀번호가 `abcd efgh ijkl mnop qrst` 라면, 아래와 같이 공백 없이 입력해주시면 됩니다:

production:
    email_delivery:
        delivery_method: :smtp
        smtp_settings:
            enable_starttls_auto: true
            address: "smtp.gmail.com"
            port: 587
            domain: "smtp.gmail.com"
            authentication: :plain
            user_name: "username@gmail.com"  # SMTP 서버로 사용할 Gmail 계정
            password: "abcd efgh ijkl mnop qrst"  # Google 웹 비밀번호

 

다음으론 별도의 SMTP 서버를 사용하는 방법입니다.

해당 기능은 회사 내부에 Redmine을 구축하면서, 이메일 알림 기능 설정이 필요했습니다.
회사에서 사용하는 SMTP 서버 정보를 아래와 같이 설정한 결과, 메일이 정상적으로 발송되는 것을 확인하였습니다.

production:
  delivery_method: :smtp                   # 메일 발송 방식은 SMTP 사용
  smtp_settings:
    address: "smtp.example.com"            # SMTP 서버 주소 (예시 도메인)
    port: 25                               # SMTP 포트 번호 (25, 587, 또는 465 사용 가능)
    domain: "example.com"                  # 메일 발송에 사용할 도메인
    # authentication: :login              # (선택) 인증 방식 설정: :plain, :login, :cram_md5
    # user_name: "your_email@example.com" # (선택) SMTP 로그인 계정
    # password: "your_password"           # (선택) SMTP 로그인 비밀번호
    # enable_starttls_auto: true          # (선택) TLS 보안 연결 사용 여부 (true 권장)

주석 처리되어 있는 항목들은 설정에서 제외해도 메일이 정상적으로 전송되는 것을 확인하였습니다.
설정 적용을 확실히 하기 위해, 이후에 apache2를 재시작해주었습니다.

$ sudo systemctl restart apache2

다음으로 Redmine 페이지에 접속하여 admin 계정으로 로그인합니다.
상단 메뉴에서 Administration → Settings → Email notifications 탭으로 이동한 후,
Emission email address 항목에 메일 주소를 입력하고 Save 버튼을 클릭하면 설정이 완료됩니다.

설정이 잘 적용되었는지 확인하고 싶다면, 우측 하단의 Send a test email 버튼을 클릭해보세요.
테스트 메일은 admin 계정에 등록된 이메일 주소로 전송됩니다.