summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRobert Speicher <robert@gitlab.com>2015-10-05 15:54:04 +0000
committerRobert Speicher <robert@gitlab.com>2015-10-05 15:54:04 +0000
commit471671f80d123a926d147518f395136b22d0e5fe (patch)
tree30e81a80027aed0ddf524b2bb9299eda963645b4
parent94dc0224e26469ad1d830104d0ac37ba21de8a9f (diff)
parent4a157e50a2083570c36542cc4ddae9a53f13575f (diff)
downloadgitlab-ce-471671f80d123a926d147518f395136b22d0e5fe.tar.gz
Merge branch 'reply-by-email-known-issue' into 'master'
Document known issue with Reply by email and multiple application servers. See merge request !1499
-rw-r--r--doc/incoming_email/README.md6
1 files changed, 5 insertions, 1 deletions
diff --git a/doc/incoming_email/README.md b/doc/incoming_email/README.md
index 01ab22321ed..316746ab54d 100644
--- a/doc/incoming_email/README.md
+++ b/doc/incoming_email/README.md
@@ -2,6 +2,10 @@
GitLab can be set up to allow users to comment on issues and merge requests by replying to notification emails.
+**Warning**: Do not enable Reply by email if you have **multiple GitLab application servers**.
+Due to an issue with the way incoming emails are read from the mail server, every incoming reply-by-email email will result in as many comments being created as you have application servers.
+[A fix is being worked on.](https://github.com/tpitale/mail_room/issues/46)
+
## Get a mailbox
Reply by email requires an IMAP-enabled email account, with a provider or server that supports [email sub-addressing](https://en.wikipedia.org/wiki/Email_address#Sub-addressing). Sub-addressing is a feature where any email to `user+some_arbitrary_tag@example.com` will end up in the mailbox for `user@example.com`, and is supported by providers such as Gmail, Yahoo! Mail, Outlook.com and iCloud, as well as the Postfix mail server which you can run on-premises.
@@ -204,4 +208,4 @@ In this example, we'll use the Gmail address `gitlab-incoming@gmail.com`.
bundle exec rake gitlab:incoming_email:check RAILS_ENV=development
```
-8. Reply by email should now be working.
+8. Reply by email should now be working. \ No newline at end of file