Commit ca63a058 authored by Achilleas Pipinellis's avatar Achilleas Pipinellis

Merge branch 'patch-16' into 'master'

add Microsoft Exchange reply by email details

Closes #28131

See merge request !9482
parents e19bcc7b 1ca5ab70
...@@ -13,7 +13,8 @@ three strategies for this feature: ...@@ -13,7 +13,8 @@ three strategies for this feature:
### Email sub-addressing ### Email sub-addressing
**If your provider or server supports email sub-addressing, we recommend using it.** **If your provider or server supports email sub-addressing, we recommend using it.
Some features (e.g. create new issue via email) only work with sub-addressing.**
[Sub-addressing](https://en.wikipedia.org/wiki/Email_address#Sub-addressing) is [Sub-addressing](https://en.wikipedia.org/wiki/Email_address#Sub-addressing) is
a feature where any email to `user+some_arbitrary_tag@example.com` will end up a feature where any email to `user+some_arbitrary_tag@example.com` will end up
...@@ -141,11 +142,31 @@ To set up a basic Postfix mail server with IMAP access on Ubuntu, follow the ...@@ -141,11 +142,31 @@ To set up a basic Postfix mail server with IMAP access on Ubuntu, follow the
gitlab_rails['incoming_email_idle_timeout'] = 60 gitlab_rails['incoming_email_idle_timeout'] = 60
``` ```
1. Reconfigure GitLab and restart mailroom for the changes to take effect: ```ruby
# Configuration for Microsoft Exchange mail server w/ IMAP enabled, assumes mailbox incoming@exchange.example.com
gitlab_rails['incoming_email_enabled'] = true
# The email address replies are sent to - Exchange does not support sub-addressing so %{key} is not used here
gitlab_rails['incoming_email_address'] = "incoming@exchange.example.com"
# Email account username
# Typically this is the userPrincipalName (UPN)
gitlab_rails['incoming_email_email'] = "incoming@ad-domain.example.com"
# Email account password
gitlab_rails['incoming_email_password'] = "[REDACTED]"
# IMAP server host
gitlab_rails['incoming_email_host'] = "exchange.example.com"
# IMAP server port
gitlab_rails['incoming_email_port'] = 993
# Whether the IMAP server uses SSL
gitlab_rails['incoming_email_ssl'] = true
```
1. Reconfigure GitLab for the changes to take effect:
```sh ```sh
sudo gitlab-ctl reconfigure sudo gitlab-ctl reconfigure
sudo gitlab-ctl restart mailroom
``` ```
1. Verify that everything is configured correctly: 1. Verify that everything is configured correctly:
...@@ -233,6 +254,35 @@ To set up a basic Postfix mail server with IMAP access on Ubuntu, follow the ...@@ -233,6 +254,35 @@ To set up a basic Postfix mail server with IMAP access on Ubuntu, follow the
idle_timeout: 60 idle_timeout: 60
``` ```
```yaml
# Configuration for Microsoft Exchange mail server w/ IMAP enabled, assumes mailbox incoming@exchange.example.com
incoming_email:
enabled: true
# The email address replies are sent to - Exchange does not support sub-addressing so %{key} is not used here
address: "incoming@exchange.example.com"
# Email account username
# Typically this is the userPrincipalName (UPN)
user: "incoming@ad-domain.example.com"
# Email account password
password: "[REDACTED]"
# IMAP server host
host: "exchange.example.com"
# IMAP server port
port: 993
# Whether the IMAP server uses SSL
ssl: true
# Whether the IMAP server uses StartTLS
start_tls: false
# The mailbox where incoming mail will end up. Usually "inbox".
mailbox: "inbox"
# The IDLE command timeout.
idle_timeout: 60
```
1. Enable `mail_room` in the init script at `/etc/default/gitlab`: 1. Enable `mail_room` in the init script at `/etc/default/gitlab`:
```sh ```sh
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment