diff --git a/en_US/iredmail-easy/2-iredmail-easy.best.practice.md b/en_US/iredmail-easy/2-iredmail-easy.best.practice.md index f7c27be7..6c9fc469 100644 --- a/en_US/iredmail-easy/2-iredmail-easy.best.practice.md +++ b/en_US/iredmail-easy/2-iredmail-easy.best.practice.md @@ -253,36 +253,61 @@ overrode by the last one. ### Roundcube -- `/opt/iredmail/custom/roundcube/custom.inc.php`. +- File `/opt/iredmail/custom/roundcube/custom.inc.php` - All your custom settings should be placed in this file, and do __NOT__ - touch main config file `/opt/www/roundcubemail/config/config.inc.php`. + All your custom settings should be placed in this file, and do __NOT__ + touch main config file `/opt/www/roundcubemail/config/config.inc.php`. -- `/opt/iredmail/custom/roundcube/plugins/`: all third-party / custom - plugins should be placed under this directory. Plugins will be linked - to `/opt/www/roundcubemail/plugins/` automatically. +- Directory `/opt/iredmail/custom/roundcube/plugins/` -- `/opt/iredmail/custom/roundcube/skins/`: all third-party / custom - skins should be placed under this directory. Skins will be linked - to `/opt/www/roundcubemail/skins/` automatically. + All third-party or custom plugins should be placed under this directory. + Plugins will be linked to `/opt/www/roundcubemail/plugins/` automatically + during iRedMail Easy deployment, but you need to create the symbol + link manually if you don't want to run another deployment. + +- Directory `/opt/iredmail/custom/roundcube/skins/` + + All third-party or custom skins should be placed under this directory. + Skins will be linked to `/opt/www/roundcubemail/skins/` automatically + during iRedMail Easy deployment, but you need to create the symbol link + manually if you don't want to run another deployment. ### SOGo -- `/opt/iredmail/custom/sogo/sogo.conf`: If this file exists, `/etc/sogo/sogo.conf` will be a symbol link to this file. -- `/opt/iredmail/custom/sogo/custom.sh`: a bash shell script for advanced customization +SOGo doesn’t support directive like `include` to load extra settings +from multiple files, so you have to either maintain your own SOGo config +file (`/opt/iredmail/custom/sogo/sogo.conf`) or use the `custom.sh` +shell script to do some customization based on the config file generated by +iRedMail Easy platform. - Currently SOGo doesn’t support `include` directive to load config - from multiple files, so you can either maintain your own SOGo config - file (`/opt/iredmail/custom/sogo/sogo.conf`) or use the `custom.sh` - shell script to do even more complex customization. +- File `/opt/iredmail/custom/sogo/sogo.conf` + + If this file exists, `/etc/sogo/sogo.conf` will be created as a symbol link + to this file during iRedMail Easy deployment. + +- Shell script `/opt/iredmail/custom/sogo/custom.sh` + + A bash shell script for advanced customization, you can customize SOGo + config file with shell commands organized in this file. + + This file will be ran by iRedMail Easy deployment each time it deploys + or upgrade SOGo component. ### iRedAPD -- `/opt/iredmail/custom/iredapd/settings.py`. It will be linked to `/opt/www/iredapd/custom_settings.py` also. +- File `/opt/iredmail/custom/iredapd/settings.py` + + All custom settings must be stored in this file. + It will be linked to `/opt/www/iredapd/custom_settings.py` during iRedMail + Easy deployment or upgrade. ### iRedAdmin -- `/opt/iredmail/custom/iredadmin/settings.py`. it will be linked to `/opt/www/iredadmin/custom_settings.py` also. +- File `/opt/iredmail/custom/iredadmin/settings.py` + + All custom settings must be stored in this file. + It will be linked to `/opt/www/iredadmin/custom_settings.py` during iRedMail + Easy deployment or upgrade. ### Amavisd diff --git a/html/iredmail-easy.best.practice.html b/html/iredmail-easy.best.practice.html index f1436656..8e2cb9bb 100644 --- a/html/iredmail-easy.best.practice.html +++ b/html/iredmail-easy.best.practice.html @@ -251,7 +251,7 @@ postconf -P "submission/inet/smtpd_client_restrictions=permit_sasl_authenti postconf -P "submission/inet/content_filter=smtp-amavis:[127.0.0.1]:10026 -

For more details about postconf command, please check its manual page: +

For more details about postconf command, please check its manual page: postconf(1).

Dovecot

Dovecot supports loading from mulitple config files, and settings will be @@ -262,40 +262,63 @@ overrode by the last one.

Roundcube

-

All your custom settings should be placed in this file, and do NOT - touch main config file /opt/www/roundcubemail/config/config.inc.php.

-

SOGo

-