diff --git a/3-faq-howto/amavisd_no_x-spam-headers.md b/3-faq-howto/amavisd.no.x-spam.headers.md similarity index 100% rename from 3-faq-howto/amavisd_no_x-spam-headers.md rename to 3-faq-howto/amavisd.no.x-spam.headers.md diff --git a/3-faq-howto/howto.configure.thunderbird.for.iredmail.md b/3-faq-howto/howto.configure.thunderbird.for.iredmail.md new file mode 100644 index 00000000..3e9171be --- /dev/null +++ b/3-faq-howto/howto.configure.thunderbird.for.iredmail.md @@ -0,0 +1,63 @@ +#Configure Thunderbird as mail client (IMAP, SMTP and global ldap address book) + +iRedMail provides POP3S (POP3 over TLS), IMAPS (IMAP over TLS), SMTPS (SMTP over TLS) for receiving and sending emails by default. + +##Create new mail account + +To create a new mail account with Thunderbird, please click menu: `File -> New -> Mail Account`. + +Add your name, email address and password in this screen. + +[[File:thunderbird.new.mail.account.png]] + +Click continue, it will detect IMAP and SMTP server automatically. + +Note: + +* Login username must be full email address. You may want to click `Edit` to ensure it is correct. +* If you want to use POP3 instead of IMAP, click "Edit" and change it to POP3 in this screen with port `110`, `STARTTLS`. + +![](images/Thunderbird.new.mail.account.setup.png "Thunderbird.new.mail.account.setup.png") + +##Configure Thunderbird as POP3 client +Warning: Make sure you're using full email address as username. + +![](images/Thunderbird.pop3.png "Thunderbird.pop3.png") + +##Configure Thunderbird as IMAP client + +Warning: Make sure you're using full email address as username. + +![](images/Thunderbird.imap.png "Thunderbird.imap.png") + +##Configure Thunderbird to send mail via SMTP + +Menu: Tools -> Account settings... -> Outgoing server (SMTP) -> Choose the server you're using. + +Warning: Make sure you're using full email address as username. + +![](images/Thunderbird.smtp.png "Thunderbird.smtp.png") + +##Use OpenLDAP as Global LDAP Address Book + +__IMPORTANT NOTE__: Thunderbird won't show contacts in LDAP address book directly, but it works when you starting typing email address in recipient field while composing email. + +Here we take Thunderbird 5.0 for example. Steps: + +* Click `Address Book` in main Thunderbird window. +* In Address Book window, click menu `File -> New -> LDAP Directory`. +* In tab `General`: +** `Name`: use whatever name you like. e.g. Global LDAP Address Book. +** `Hostname`: IP address or hostname of your iRedMail server. +** `Base DN`: Base dn of your domain in LDAP directory. Normally, it's `domainName=domain.ltd,o=domains,dc=xxx,dc=xxx`. For example, `domainName=example.com,o=domains,dc=iredmail,dc=org`. +** `Port Number`: 389. __Note__: If you prefer to connect to OpenLDAP server over SSL, please check the `Use secure connection (SSL)` under same tab. +** `Bind DN`: It's full LDAP dn of your mail account. Normally, it's `mail=user@domain.ltd,ou=Users,domainName=domain.ltd,o=domains,dc=xxx,dc=xxx`. For example: `mail=john@example.com,ou=Users,domainName=example.com,o=domains,dc=iredmail,dc=org`. +* In tab `Advanced`: +** `Don't return more than xxx results`: depends on how many accounts stored in same domain, you may want to increase or descrease it. Default value in 100. +** `Scope`: Subtree. +** `Search filter`: `(&(enabledService=mail)(enabledService=deliver)(enabledService=displayedInGlobalAddressBook)(|(objectClass=mailList)(objectClass=mailAlias)(objectClass=mailUser)))` +** `Login method`: `Simple`. + +* Now switch to tab `Offline`, click button `Download Now` to test your settings. It will prompt to input password for this LDAP server, just type password of your mail account. With correct bind dn and password, it will display `Replicated succeeded`. + +That's all. diff --git a/3-faq-howto/how-to-enable-smtps-service.md b/3-faq-howto/howto.enable.smtps.service.md similarity index 100% rename from 3-faq-howto/how-to-enable-smtps-service.md rename to 3-faq-howto/howto.enable.smtps.service.md diff --git a/howto.configure.thunderbird.for.iredmail.md b/howto.configure.thunderbird.for.iredmail.md deleted file mode 100644 index 9be34c65..00000000 --- a/howto.configure.thunderbird.for.iredmail.md +++ /dev/null @@ -1,61 +0,0 @@ - -#How to configure Microsoft Outlook to use OpenLDAP as global LDAP address book -iRedMail provides POP3, POP3S (pop3 over TLS), IMAP, IMAPS (imap over TLS), SMTP, SMTPS (smtp over TLS) for receiving and sending emails by default. - -##Create new mail account -Menu: File -> New -> Mail Account. - -Add your name, email address and password in this screen. - -[[File:Thunderbird.new.mail.account.png]] - -Click continue, it will detect IMAP and SMTP server automatically. - -Note: -* You should click "Edit" to input full email address as username. -* If you want to use POP3 instead of IMAP, click "Edit" and change it to POP3 in this screen with port 110, STARTTLS. - -![](images/Thunderbird.new.mail.account.setup.png "Thunderbird.new.mail.account.setup.png") - -##Configure Thunderbird as POP3 client -Warning: Make sure you're using full email address as username. - -![](images/Thunderbird.pop3.png "Thunderbird.pop3.png") - -##Configure Thunderbird as IMAP client - -Warning: Make sure you're using full email address as username. - -![](images/Thunderbird.imap.png "Thunderbird.imap.png") - -##Configure Thunderbird to send mail via SMTP - -Menu: Tools -> Account settings... -> Outgoing server (SMTP) -> Choose the server you're using. - -Warning: Make sure you're using full email address as username. - -![](images/Thunderbird.smtp.png "Thunderbird.smtp.png") - -##Use OpenLDAP as Global LDAP Address Book - -__IMPORTANT NOTE__: Thunderbird won't show you contacts in LDAP address book directly, but it works when you starting typing email address in recipient field while composing email. - -Here we take Thunderbird 5.0 for example. Steps: - -* Click __Address Book__ in main window. -* In Address Book window, click __File -> New -> LDAP Directory__. -* In tab __General__: -** __Name__: use whatever name you like. e.g. Mail Server Address Book. -** __Hostname__: IP address or hostname of your iRedMail server. -** __Base DN__: Base dn of your domain in LDAP directory. Normally, it's __domainName=domain.ltd,o=domains,dc=xxx,dc=xxx__. For example, __domainName=example.com,o=domains,dc=iredmail,dc=org__. -** __Port Number__: 389. Note: If you prefer to connect to OpenLDAP server over SSL, please check the __Use secure connection (SSL)__ in same tab. -** __Bind DN__: It's dn of your mail account. Normally, it's __mail=user@domain.ltd,ou=Users,domainName=domain.ltd,o=domains,dc=xxx,dc=xxx__. For example: __mail=john@example.com,ou=Users,domainName=example.com,o=domains,dc=iredmail,dc=org__. -* In tab __Advanced__: -** __Don't return more than xxx results__: it depends on how many accounts stored in same domain. You can set it to 100, or 1000. 100 is default value in Thunderbird. -** __Scope__: Subtree. -** __Search filter__: (&(enabledService=mail)(enabledService=deliver)(enabledService=displayedInGlobalAddressBook)(|(objectClass=mailList)(objectClass=mailAlias)(objectClass=mailUser))) -** __Login method__: Simple. - -* Now switch to tab __Offline__, click button __Download Now__ to test your settings. It will prompt to input password for this LDAP server, just type password of your mail account. With correct __Bind DN__ and password, it will display __Replicated succeeded__. - -That's all. diff --git a/html/faq-howto/completely.disable.amavisd.clamav.spamassassin.html b/html/faq-howto/completely.disable.amavisd.clamav.spamassassin.html new file mode 100644 index 00000000..7853b262 --- /dev/null +++ b/html/faq-howto/completely.disable.amavisd.clamav.spamassassin.html @@ -0,0 +1,52 @@ + + + + + + + + +

+

How to completely disable amavisd/ClamAV/SpamAssassin

+

In iRedMail, Amavisd provides below features:

+ +

Stop virus/spam scanning, keep DKIM signing/verification and Disclaimer

+

If you want to disable virus and spam scanning, but keep DKIM signing and disclaimer, please try this:

+ +
# @bypass_virus_checks_maps = (1);  # controls running of anti-virus code
+# @bypass_spam_checks_maps  = (1);  # controls running of anti-spam code
+
+ +

Uncomment above lines (removing "# " at the beginning of each line), and restart Amavisd service.

+

Completely disable all features

+

If you want to completely disable spam and virus scanning services, steps:

+ +
content_filter = smtp-amavis:[127.0.0.1]:10024
+receive_override_options = no_address_mappings
+
+ + +

Notes:

+ \ No newline at end of file diff --git a/html/faq-howto/disable.spam.virus.scanning.for.outgoing.mails.html b/html/faq-howto/disable.spam.virus.scanning.for.outgoing.mails.html new file mode 100644 index 00000000..f78e7571 --- /dev/null +++ b/html/faq-howto/disable.spam.virus.scanning.for.outgoing.mails.html @@ -0,0 +1,32 @@ + + + + + + + + +

+

How to disable spam virus scanning for outgoing mails

+

To disable spam/virus scanning for outgoing mails, you can add bypass settings in Amavisd config file: /etc/amavisd/amavisd.conf (RHEL/CentOS/Scientific Linux) or /etc/amavis/conf.d/50-user (Debian/Ubuntu) or /usr/local/etc/amavisd.conf (FreeBSD).

+ +

These settings can be added in setting block $policy_bank{'MYUSERS'}:

+
$policy_bank{'MYUSERS'} = {
+    [...OMIT OTHER SETTINGS HERE...]
+
+    # don't perform spam/virus/header check.
+    bypass_spam_checks_maps => [1],
+    bypass_virus_checks_maps => [1],
+    bypass_header_checks_maps => [1],
+
+    # allow sending any file names and types
+    bypass_banned_checks_maps => [1],
+}
+
+ +

Restarting Amavisd service is required after changing settings.

\ No newline at end of file diff --git a/html/faq-howto/howto.configure.thunderbird.for.iredmail.html b/html/faq-howto/howto.configure.thunderbird.for.iredmail.html new file mode 100644 index 00000000..fe0444df --- /dev/null +++ b/html/faq-howto/howto.configure.thunderbird.for.iredmail.html @@ -0,0 +1,56 @@ + + + + + + + + +

+

Configure Thunderbird as mail client (IMAP, SMTP and global ldap address book)

+

iRedMail provides POP3S (POP3 over TLS), IMAPS (IMAP over TLS), SMTPS (SMTP over TLS) for receiving and sending emails by default.

+

Create new mail account

+

To create a new mail account with Thunderbird, please click menu: File -> New -> Mail Account.

+

Add your name, email address and password in this screen.

+

[[File:thunderbird.new.mail.account.png]]

+

Click continue, it will detect IMAP and SMTP server automatically.

+

Note:

+ +

+

Configure Thunderbird as POP3 client

+

Warning: Make sure you're using full email address as username.

+

+

Configure Thunderbird as IMAP client

+

Warning: Make sure you're using full email address as username.

+

+

Configure Thunderbird to send mail via SMTP

+

Menu: Tools -> Account settings... -> Outgoing server (SMTP) -> Choose the server you're using.

+

Warning: Make sure you're using full email address as username.

+

+

Use OpenLDAP as Global LDAP Address Book

+

IMPORTANT NOTE: Thunderbird won't show contacts in LDAP address book directly, but it works when you starting typing email address in recipient field while composing email.

+

Here we take Thunderbird 5.0 for example. Steps:

+ +

That's all.

\ No newline at end of file diff --git a/html/index.html b/html/index.html index 1c23ab7e..7d746fe9 100644 --- a/html/index.html +++ b/html/index.html @@ -9,4 +9,7 @@

Frequently Asked Questions and Howto documents

Amavisd + SpamAssassin not working, no mail header (X-Spam-*) inserted.

-

How to enable SMTPS service (SMTP over SSL, port 465)

\ No newline at end of file +

How to completely disable amavisd/ClamAV/SpamAssassin

+

How to disable spam virus scanning for outgoing mails

+

How to enable SMTPS service (SMTP over SSL, port 465)

+

Configure Thunderbird as mail client (IMAP, SMTP and global ldap address book)

\ No newline at end of file