From b943c07d0cf7afe3f3f7c04abd0af304dbe44ef7 Mon Sep 17 00:00:00 2001
From: Zhang Huangbin
Date: Thu, 6 Sep 2018 18:39:28 +0800
Subject: [PATCH] Mention throttle setting impacts attachment size limit.
---
en_US/howto/1-change.mail.attachment.size.md | 23 ++++++++++++++++--
en_US/howto/manage.iredapd.md | 4 +++-
html/change.mail.attachment.size.html | 25 +++++++++++++++++---
html/manage.iredapd.html | 3 ++-
4 files changed, 48 insertions(+), 7 deletions(-)
diff --git a/en_US/howto/1-change.mail.attachment.size.md b/en_US/howto/1-change.mail.attachment.size.md
index d90972f4..9135d9ad 100644
--- a/en_US/howto/1-change.mail.attachment.size.md
+++ b/en_US/howto/1-change.mail.attachment.size.md
@@ -56,14 +56,33 @@ __NOTES__:
If you use mail clients such as Outlook, thunderbird to send mails, it's now
ok to sent large attachment with above setting.
+## Change message size limit in iRedAPD
+
+> * iRedAPD is a Postfix policy server developed and maintained by iRedMail team.
+> * With default iRedMail setting, no message size limit is set.
+> * For more details, please check tutorial: [Manage iRedAPD](./manage.iredapd.html).
+
+With plugin `throttle` enabled in iRedAPD config file (`/opt/iredapd/settings.py`),
+iRedAPD will query throttle settings from SQL database (SQL table `iredapd.throttle`),
+if there's a global, per-domain or per-user message size limit set for sender
+or recipient, it will performs the check.
+
+Both Postfix and iRedAPD check the size of single message, if the message size reaches
+the limit of either Postfix setting or iRedAPD throttle setting, the email will
+be rejected.
+
+You can set the throttle with iRedAdmin-Pro, or with SQL command tool, for more
+details, please check plugin source file, it's detailed with examples and
+explanation: [Throttle plugin](https://bitbucket.org/zhb/iredapd/src/default/plugins/throttle.py).
+
## Change upload file size in Roundcube webmail
If you have Roundcube webmail, please change two more settings:
-### Change PHP setting to allow to upload large attachment
+### Change PHP settings for uploading large attachment
You should change `memory_limit`, `upload_max_filesize` and `post_max_size` in
-PHP config file `/etc/php.ini`
+PHP config file `/etc/php.ini`.
* on RHEL/CentOS: it's `/etc/php.ini`
* on Debian/Ubuntu, it's `/etc/php5/apache2/php.ini`.
diff --git a/en_US/howto/manage.iredapd.md b/en_US/howto/manage.iredapd.md
index e3f0b20e..c42a2780 100644
--- a/en_US/howto/manage.iredapd.md
+++ b/en_US/howto/manage.iredapd.md
@@ -10,9 +10,11 @@
## Introduce iRedAPD
iRedAPD is a simple Postfix policy server, written in Python, with plugin
-support. it listens on port `7777` by default, and runs as a low-privileged
+support. It listens on `127.0.0.1:7777` by default, and runs as a low-privileged
user `iredapd`.
+Source code is hosted on [BitBucket](https://bitbucket.org/zhb/iredapd/).
+
## How to disable iRedAPD service
To disable iRedAPD service:
diff --git a/html/change.mail.attachment.size.html b/html/change.mail.attachment.size.html
index f361c933..29abb465 100644
--- a/html/change.mail.attachment.size.html
+++ b/html/change.mail.attachment.size.html
@@ -24,8 +24,9 @@
If you use mail clients such as Outlook, thunderbird to send mails, it's now
ok to sent large attachment with above setting.
+Change message size limit in iRedAPD
+
+
+- iRedAPD is a Postfix policy server developed and maintained by iRedMail team.
+- With default iRedMail setting, no message size limit is set.
+- For more details, please check tutorial: Manage iRedAPD.
+
+
+With plugin throttle
enabled in iRedAPD config file (/opt/iredapd/settings.py
),
+iRedAPD will query throttle settings from SQL database (SQL table iredapd.throttle
),
+if there's a global, per-domain or per-user message size limit set for sender
+or recipient, it will performs the check.
+Both Postfix and iRedAPD check the size of single message, if the message size reaches
+the limit of either Postfix setting or iRedAPD throttle setting, the email will
+be rejected.
+You can set the throttle with iRedAdmin-Pro, or with SQL command tool, for more
+details, please check plugin source file, it's detailed with examples and
+explanation: Throttle plugin.
Change upload file size in Roundcube webmail
If you have Roundcube webmail, please change two more settings:
-Change PHP setting to allow to upload large attachment
+Change PHP settings for uploading large attachment
You should change memory_limit
, upload_max_filesize
and post_max_size
in
-PHP config file /etc/php.ini
+PHP config file /etc/php.ini
.
- on RHEL/CentOS: it's
/etc/php.ini
- on Debian/Ubuntu, it's
/etc/php5/apache2/php.ini
.