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.
This commit is contained in:
Tim Abbott 2021-10-14 14:46:00 -07:00
parent a88ace988a
commit a87bbe22be

View File

@ -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/