From a87bbe22be49bdbc59b7b984e84f87af53efd52a Mon Sep 17 00:00:00 2001 From: Tim Abbott Date: Thu, 14 Oct 2021 14:46:00 -0700 Subject: [PATCH] docs: Document how to test the polling email gateway configuration. We don't recommend this configuration, so it's rarely used, but it's worth a few minutes to have nice documentation. Fixes #19565. --- docs/production/email-gateway.md | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/docs/production/email-gateway.md b/docs/production/email-gateway.md index a9116ddf96..aa197e8c4c 100644 --- a/docs/production/email-gateway.md +++ b/docs/production/email-gateway.md @@ -118,7 +118,16 @@ Congratulations! The integration should be fully operational. in the email gateway integration section (`EMAIL_GATEWAY_LOGIN` and others). - Password in `/etc/zulip/zulip-secrets.conf` as `email_gateway_password`. -1. Install a cron job to poll the inbox every minute for new messages: +1. Test your configuration by sending emails to the target email + account and then running the Zulip tool to poll that inbox: + + ``` + su zulip -c '/home/zulip/deployments/current/manage.py email_mirror' + ``` + +1. Once everything is working, Install the cron job which will poll + the inbox every minute for new messages using the tool you tested + in the last step: ```bash cd /home/zulip/deployments/current/ sudo cp puppet/zulip/files/cron.d/email-mirror /etc/cron.d/