Move articles.
This commit is contained in:
parent
16b173c5c4
commit
e27078a9ad
|
@ -1 +1 @@
|
||||||
Frequently Asked Questions and Howto documents
|
Frequently Asked Questions
|
||||||
|
|
|
@ -0,0 +1,30 @@
|
||||||
|
# Why append timestamp in maildir path
|
||||||
|
|
||||||
|
iRedMail will append timestamp in maildir path by default, here's why.
|
||||||
|
|
||||||
|
Depends on the tools/scripts you used to create mail accounts, it's tunable
|
||||||
|
in scripts shipped within iRedMail and iRedAdmin (file `settings.py`, variable
|
||||||
|
`MAILDIR_APPEND_TIMESTAMP = True` or `False').
|
||||||
|
|
||||||
|
Deleting mail accounts with iRedAdmin will not remove the mailboxes on file
|
||||||
|
system, so that you can keep user's mailbox for some time.
|
||||||
|
|
||||||
|
Think about this situation:
|
||||||
|
|
||||||
|
* Employee Michael Jordan has email address mj@domain.ltd. Without timestamp
|
||||||
|
in maildir path, the maildir path of his mailbox looks like
|
||||||
|
`/var/vmail/vmail1/domain.ltd/mj/`.
|
||||||
|
|
||||||
|
* Michael left company, and your company deleted his mail account. With
|
||||||
|
iRedAdmin, it just deletes mail accounts stored in LDAP/SQL server, not delete
|
||||||
|
his mailbox on file system (`var/vmail/vmail1/domain.ltd/mj`).
|
||||||
|
|
||||||
|
* A new talent joined in, his name is Mike Jackson, and he want to use
|
||||||
|
`mj@domain.ltd` since `mj@` is not used by others. And you created it for him.
|
||||||
|
Without timestamp in maildir path, the maildir path of Mike's mailbox is the
|
||||||
|
same as Michael's `/var/vmail/vmail1/domain.ltd/mj/`.
|
||||||
|
|
||||||
|
iRedAdmin doesn't remove the mailboxes on file system, so Mike will see all
|
||||||
|
emails in Michael's mailbox if Michael didn't delete them. To avoid this, we
|
||||||
|
append a timestamp in maildir path to make sure all users will be assigned
|
||||||
|
a unique maildir paths.
|
|
@ -0,0 +1 @@
|
||||||
|
How to
|
6
URLs.md
6
URLs.md
|
@ -1,11 +1,7 @@
|
||||||
= wiki FAQ =
|
= wiki FAQ =
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
http://www.iredmail.org/wiki/index.php?title=IRedMail/FAQ/Ignore.Trash.Folder.in.Quota
|
|
||||||
http://www.iredmail.org/wiki/index.php?title=IRedMail/FAQ/why.iredmail.append.timestamp.in.maildir.path
|
http://www.iredmail.org/wiki/index.php?title=IRedMail/FAQ/why.iredmail.append.timestamp.in.maildir.path
|
||||||
|
http://www.iredmail.org/wiki/index.php?title=IRedMail/FAQ/Ignore.Trash.Folder.in.Quota
|
||||||
http://www.iredmail.org/wiki/index.php?title=IRedMail/FAQ/LDAP/Add.Mail.Forwarding.Address
|
http://www.iredmail.org/wiki/index.php?title=IRedMail/FAQ/LDAP/Add.Mail.Forwarding.Address
|
||||||
http://www.iredmail.org/wiki/index.php?title=IRedMail/FAQ/LDAP/Add.Mail.Forwarding.Address
|
http://www.iredmail.org/wiki/index.php?title=IRedMail/FAQ/LDAP/Add.Mail.Forwarding.Address
|
||||||
http://www.iredmail.org/wiki/index.php?title=IRedMail/FAQ/LDAP/Add.Maillist.with.phpLDAPadmin
|
http://www.iredmail.org/wiki/index.php?title=IRedMail/FAQ/LDAP/Add.Maillist.with.phpLDAPadmin
|
||||||
|
|
12
convert.sh
12
convert.sh
|
@ -31,10 +31,10 @@ strip_name_prefix()
|
||||||
|
|
||||||
# Get directories of chapters
|
# Get directories of chapters
|
||||||
all_chapter_dirs="$(find . -d 1 -type d -iname '[0-9]*' | sort)"
|
all_chapter_dirs="$(find . -d 1 -type d -iname '[0-9]*' | sort)"
|
||||||
echo "* Found chapters:"
|
#echo "* Found chapters:"
|
||||||
for dl in ${all_chapter_dirs}; do
|
#for dl in ${all_chapter_dirs}; do
|
||||||
echo " - $dl"
|
# echo " - $dl"
|
||||||
done
|
#done
|
||||||
|
|
||||||
# Get chapter info
|
# Get chapter info
|
||||||
# - title: _title.md
|
# - title: _title.md
|
||||||
|
@ -97,7 +97,7 @@ done
|
||||||
#cd ${OUTPUT_DIR}
|
#cd ${OUTPUT_DIR}
|
||||||
|
|
||||||
# Generate index.html
|
# Generate index.html
|
||||||
${CMD_CONVERT} ${INDEX_MD} ${OUTPUT_DIR} css='./css/markdown.css'
|
${CMD_CONVERT} ${INDEX_MD} ${OUTPUT_DIR} css='./css/markdown.css' title="iRedMail Documentations"
|
||||||
|
|
||||||
# Cleanup
|
# Cleanup
|
||||||
rm -f ${INDEX_MD}
|
#rm -f ${INDEX_MD}
|
||||||
|
|
|
@ -1,133 +0,0 @@
|
||||||
<html>
|
|
||||||
<head>
|
|
||||||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
||||||
<title>How to migrate old iRedMail server to the latest stable release</title>
|
|
||||||
<link href="../css/markdown.css" rel="stylesheet"></head>
|
|
||||||
</head>
|
|
||||||
|
|
||||||
<body>
|
|
||||||
<h1 id="how-to-migrate-old-iredmail-server-to-the-latest-stable-release">How to migrate old iRedMail server to the latest stable release</h1>
|
|
||||||
<div class="toc">
|
|
||||||
<ul>
|
|
||||||
<li><a href="#how-to-migrate-old-iredmail-server-to-the-latest-stable-release">How to migrate old iRedMail server to the latest stable release</a><ul>
|
|
||||||
<li><a href="#client-settings-outlook-thunderbird">Client settings (Outlook, Thunderbird)</a></li>
|
|
||||||
<li><a href="#ldap-migrate-mail-accounts">LDAP: migrate mail accounts</a></li>
|
|
||||||
<li><a href="#mysqlpostgresql-migrate-mail-accounts">MySQL/PostgreSQL: Migrate mail accounts</a></li>
|
|
||||||
<li><a href="#migrate-mailboxes-maildir-format">Migrate mailboxes (Maildir format)</a></li>
|
|
||||||
<li><a href="#migrate-roundcube-webmail-data">Migrate Roundcube webmail data</a></li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
</ul>
|
|
||||||
</div>
|
|
||||||
<p><code>WARNING</code>: Please try it on a test server first. if it works well, then try it on product server.</p>
|
|
||||||
<p>Since new iRedMail server will install same components as old server, you can choose what data you want to migrate. Most important data are:</p>
|
|
||||||
<ul>
|
|
||||||
<li>email accounts stored in SQL/LDAP.</li>
|
|
||||||
<li>user mailboxes. Stored under /var/vmail by default.</li>
|
|
||||||
<li>SQL database of Roundcube webmail. It stores per-user webmail preferences, and address book.</li>
|
|
||||||
<li>Policyd/Cluebringer database. It stores white/blacklists records, greylisting records, etc.</li>
|
|
||||||
<li>Amavisd database.<ul>
|
|
||||||
<li>It stores per-recipient white/blacklists in SQL tables: <code>mailaddr</code>, <code>policy</code>, <code>users</code>, <code>wblist</code>.</li>
|
|
||||||
<li>Basic info of in/out emails are stored in SQL tables: <code>maddr</code>, <code>msgs</code>, <code>msgrcpt</code>. Quarantined emails are stored in <code>quarantine</code>, it requires other 3 tables. If you don't have any quarantined emails, it's safe to delete all records in these 4 tables.</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
</ul>
|
|
||||||
<p><strong>WARNING</strong>: Do not restore database <code>mysql</code> exported from old server, it contains SQL usernames/passwords for Roundcube/Amavisd/Policyd/Cluebringer used on old server. New iRedMail server has the same SQL usernames, but different passwords. So please do not restore it.</p>
|
|
||||||
<h2 id="client-settings-outlook-thunderbird">Client settings (Outlook, Thunderbird)</h2>
|
|
||||||
<p>Since iRedMail-0.8.7, iRedMail enforces secure POP3/IMAP/SMTP connections.
|
|
||||||
Mail client programs must issue 'STARTTLS' command before authentication,
|
|
||||||
so please update your mail client programs you must change your mail client
|
|
||||||
programs (e.g. Outlook, Thunderbird) to use TLS connection.</p>
|
|
||||||
<ul>
|
|
||||||
<li>For SMTP service, use port <code>587</code> with <code>STARTTLS</code> (or <code>TLS</code>).</li>
|
|
||||||
<li>For IMAP service, use port <code>143</code> with <code>STARTTLS</code> (or <code>TLS</code>).</li>
|
|
||||||
<li>For POP3 service, use port <code>110</code> with <code>STARTTLS</code> (or <code>TLS</code>).</li>
|
|
||||||
</ul>
|
|
||||||
<p>Addition notes:</p>
|
|
||||||
<ul>
|
|
||||||
<li>
|
|
||||||
<p>If you want to enable smtp authentication on port <code>25</code> (again, not
|
|
||||||
recommended), please comment out Postfix parameter <code>smtpd_tls_auth_only = yes</code>
|
|
||||||
in its config file <code>/etc/postfix/main.cf</code>.</p>
|
|
||||||
</li>
|
|
||||||
<li>
|
|
||||||
<p>if you want to enable SMTPS (SMTP over SSL, port <code>465</code>) to support legency
|
|
||||||
mail clients, please follow this tutorial: (How to enable SMTPS service)[./faq-howto/howto.enable.smtps.service].</p>
|
|
||||||
</li>
|
|
||||||
</ul>
|
|
||||||
<h2 id="ldap-migrate-mail-accounts">LDAP: migrate mail accounts</h2>
|
|
||||||
<p>Steps to migrate LDAP mail accounts:</p>
|
|
||||||
<ul>
|
|
||||||
<li>Setup a new server with the latest iRedMail, and make iRedAdmin-Pro-LDAP work as expected.</li>
|
|
||||||
<li>Export mail accounts from LDAP on OLD mail server.</li>
|
|
||||||
</ul>
|
|
||||||
<p>Normally, LDAP data can be exported into LDIF format. Here's backup/export script: <a href="http://www.iredmail.org/wiki/index.php?title=IRedMail/FAQ/Backup">http://www.iredmail.org/wiki/index.php?title=IRedMail/FAQ/Backup</a></p>
|
|
||||||
<p><strong>Note</strong>:
|
|
||||||
<em> There might be some changes in LDAP schema, please find scripts in below URL to apply all required changes: <a href="https://bitbucket.org/zhb/iredmail/src/default/extra/update/">https://bitbucket.org/zhb/iredmail/src/default/extra/update/</a>
|
|
||||||
</em> You can find all upgrade tutorials of iRedMail here: <a href="http://www.iredmail.org/doc.html#upgrade_tutorial">http://www.iredmail.org/doc.html#upgrade_tutorial</a></p>
|
|
||||||
<h2 id="mysqlpostgresql-migrate-mail-accounts">MySQL/PostgreSQL: Migrate mail accounts</h2>
|
|
||||||
<p>All mail accounts are stored in database <code>vmail</code> by default, to migrate mail
|
|
||||||
accounts, you can simply export this database on old server, then import it
|
|
||||||
on new server.</p>
|
|
||||||
<p><strong>IMPORTANT NOTE</strong>: iRedMail-0.8.7 drops several SQL columns, so before you
|
|
||||||
import backup SQL database, please add them first. It's safe to drop them
|
|
||||||
after you imported old database on new server.</p>
|
|
||||||
<pre><code class="mysql">mysql> USE vmail;
|
|
||||||
|
|
||||||
mysql> ALTER TABLE mailbox ADD COLUMN bytes BIGINT(20) NOT NULL DEFAULT 0;
|
|
||||||
mysql> ALTER TABLE mailbox ADD COLUMN messages BIGINT(20) NOT NULL DEFAULT 0;
|
|
||||||
|
|
||||||
mysql> ALTER TABLE domain ADD COLUMN defaultlanguage VARCHAR(5) NOT NULL DEFAULT 'en_US';
|
|
||||||
mysql> ALTER TABLE domain ADD COLUMN defaultuserquota BIGINT(20) NOT NULL DEFAULT '1024';
|
|
||||||
mysql> ALTER TABLE domain ADD COLUMN defaultuseraliases TEXT;
|
|
||||||
mysql> ALTER TABLE domain ADD COLUMN disableddomainprofiles VARCHAR(255) NOT NULL DEFAULT '';
|
|
||||||
mysql> ALTER TABLE domain ADD COLUMN disableduserprofiles VARCHAR(255) NOT NULL DEFAULT '';
|
|
||||||
mysql> ALTER TABLE domain ADD COLUMN defaultpasswordscheme VARCHAR(10) NOT NULL DEFAULT '';
|
|
||||||
mysql> ALTER TABLE domain ADD COLUMN minpasswordlength INT(10) NOT NULL DEFAULT 0;
|
|
||||||
mysql> ALTER TABLE domain ADD COLUMN maxpasswordlength INT(10) NOT NULL DEFAULT 0;
|
|
||||||
|
|
||||||
mysql> ALTER TABLE alias ADD COLUMN islist TINYINT(1) NOT NULL DEFAULT 0;
|
|
||||||
</code></pre>
|
|
||||||
|
|
||||||
<p>After imported backup SQL databases, please execute below commands to mark
|
|
||||||
mail alias accounts and drop above newly created columns:</p>
|
|
||||||
<pre><code class="mysql">mysql> USE vmail;
|
|
||||||
mysql> UPDATE alias SET islist=1 WHERE address NOT IN (SELECT username FROM mailbox);
|
|
||||||
mysql> UPDATE alias SET islist=0 WHERE address=domain; -- domain catch-all account
|
|
||||||
|
|
||||||
-- Store values into new column: domain.settings and drop them
|
|
||||||
mysql> UPDATE domain SET settings='';
|
|
||||||
mysql> UPDATE domain SET settings=CONCAT(settings, IF(defaultlanguage IS NULL OR defaultlanguage='', '', CONCAT('default_language:', defaultlanguage, ';')));
|
|
||||||
mysql> UPDATE domain SET settings=CONCAT(settings, IF(defaultuserquota IS NULL OR defaultuserquota=0, '', CONCAT('default_user_quota:', defaultuserquota, ';')));
|
|
||||||
mysql> UPDATE domain SET settings=CONCAT(settings, IF(defaultuseraliases IS NULL OR defaultuseraliases='', '', CONCAT('default_groups:', defaultuseraliases, ';')));
|
|
||||||
mysql> UPDATE domain SET settings=CONCAT(settings, IF(minpasswordlength IS NULL OR minpasswordlength=0, '', CONCAT('min_passwd_length:', minpasswordlength, ';')));
|
|
||||||
mysql> UPDATE domain SET settings=CONCAT(settings, IF(maxpasswordlength IS NULL OR maxpasswordlength=0, '', CONCAT('max_passwd_length:', maxpasswordlength, ';')));
|
|
||||||
mysql> UPDATE domain SET settings=CONCAT(settings, IF(disableddomainprofiles IS NULL OR disableddomainprofiles='', '', CONCAT('disabled_domain_profiles:', disableddomainprofiles, ';')));
|
|
||||||
mysql> UPDATE domain SET settings=CONCAT(settings, IF(disableduserprofiles IS NULL OR disableduserprofiles='', '', CONCAT('disabled_user_profiles:', disableduserprofiles, ';')));
|
|
||||||
|
|
||||||
mysql> ALTER TABLE domain DROP defaultlanguage;
|
|
||||||
mysql> ALTER TABLE domain DROP defaultuserquota;
|
|
||||||
mysql> ALTER TABLE domain DROP defaultuseraliases;
|
|
||||||
mysql> ALTER TABLE domain DROP minpasswordlength;
|
|
||||||
mysql> ALTER TABLE domain DROP maxpasswordlength;
|
|
||||||
mysql> ALTER TABLE domain DROP disableddomainprofiles;
|
|
||||||
mysql> ALTER TABLE domain DROP disableduserprofiles;
|
|
||||||
</code></pre>
|
|
||||||
|
|
||||||
<p><strong>IMPORTANT NOTE</strong>: There might be some changes in SQL structure, please read
|
|
||||||
all upgrade tutorials for your current iRedMail release, then apply SQL
|
|
||||||
structure related changes. For example:
|
|
||||||
<a href="http://www.iredmail.org/wiki/index.php?title=Upgrade/iRedMail/0.7.4-0.8.0#Add_internal_service_required_by_Doveadm_2">http://www.iredmail.org/wiki/index.php?title=Upgrade/iRedMail/0.7.4-0.8.0#Add_internal_service_required_by_Doveadm_2</a></p>
|
|
||||||
<h2 id="migrate-mailboxes-maildir-format">Migrate mailboxes (Maildir format)</h2>
|
|
||||||
<ul>
|
|
||||||
<li>Simply copy all mailboxes (in Maildir format) to new iRedMail server.</li>
|
|
||||||
<li>Set correct file owner of mailboxes. Default owner is <code>vmail</code>, group is <code>vmail</code>.</li>
|
|
||||||
<li>Set correct file permission of mailboxes. Default is <code>0700</code>.</li>
|
|
||||||
</ul>
|
|
||||||
<p>WARNING: please make sure maildir path stored in SQL/LDAP matches the mailbox
|
|
||||||
path on file system, so that mail clients can find imported emails.</p>
|
|
||||||
<h2 id="migrate-roundcube-webmail-data">Migrate Roundcube webmail data</h2>
|
|
||||||
<ul>
|
|
||||||
<li>Export/import roundcube webmail database, and upgrade database to work with new version of Roundcube.
|
|
||||||
<a href="http://trac.roundcube.net/wiki/Howto_Upgrade">http://trac.roundcube.net/wiki/Howto_Upgrade</a></li>
|
|
||||||
</ul></body></html>
|
|
|
@ -1,10 +0,0 @@
|
||||||
<html>
|
|
||||||
<head>
|
|
||||||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
||||||
<title></title>
|
|
||||||
<link href="../../css/markdown.css" rel="stylesheet"></head>
|
|
||||||
</head>
|
|
||||||
|
|
||||||
<body>
|
|
||||||
<h3></h3>
|
|
||||||
<p>This is most frequently asked questions.</p></body></html>
|
|
|
@ -1,69 +0,0 @@
|
||||||
<html>
|
|
||||||
<head>
|
|
||||||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
||||||
<title> How to use or migrate password hashes</title>
|
|
||||||
<link href="../css/markdown.css" rel="stylesheet"></head>
|
|
||||||
</head>
|
|
||||||
|
|
||||||
<body>
|
|
||||||
<h1 id="how-to-use-or-migrate-password-hashes">How to use or migrate password hashes</h1>
|
|
||||||
<h2 id="password-hashes-supported-by-iredmail">Password hashes supported by iRedMail</h2>
|
|
||||||
<p>iRedMail configures Postfix to use Dovecot as SASL authenticate server, so all
|
|
||||||
password schemes supported by Dovecot can be used in iRedMail. Please refer to
|
|
||||||
Dovecot wiki page
|
|
||||||
<a href="http://wiki2.dovecot.org/Authentication/PasswordSchemes"><code>Password Schemes</code></a> for more details.</p>
|
|
||||||
<p>Below password schemes are supported in iRedAdmin-Pro (which means you can add new mail user with either one):</p>
|
|
||||||
<ul>
|
|
||||||
<li>Plain text. e.g. <code>123456</code></li>
|
|
||||||
<li>MD5. (salted. e.g. <code>$1$GfHYI7OE$vlXqMZSyJOSPXAmbXHq250</code></li>
|
|
||||||
<li>PLAIN-MD5 (unsalted MD5). e.g. <code>0d2bf3c712402f428d48fed691850bfc</code></li>
|
|
||||||
<li>SSHA. e.g. <code>{SSHA}OuCrqL2yWwQIu8a9uvyOQ5V/ZKfL7LJD</code></li>
|
|
||||||
<li>SSHA512. e.g. <code>{SSHA512}FxgXDhBVYmTqoboW+ibyyzPv/wGG7y4VJtuHWrx+wfqrs/lIH2Qxn2eA0jygXtBhMvRi7GNFmL++6aAZ0kXpcy1fxag=</code></li>
|
|
||||||
</ul>
|
|
||||||
<p><strong>NOTE</strong>: Dovecot claims it supports SSHA512, but I didn't get it work.
|
|
||||||
Please test it first if you choose SSHA512.</p>
|
|
||||||
<h2 id="default-password-schemes-used-in-iredmail">Default password schemes used in iRedMail</h2>
|
|
||||||
<ul>
|
|
||||||
<li>For MySQL and PostgreSQL backends: <code>MD5</code> (salted).</li>
|
|
||||||
<li>For LDAP backend: <code>SSHA</code>.</li>
|
|
||||||
</ul>
|
|
||||||
<h2 id="how-to-use-different-password-hashes-in-iredmail">How to use different password hashes in iRedMail</h2>
|
|
||||||
<h3 id="for-mysql-and-postgresql-backends">For MySQL and PostgreSQL backends</h3>
|
|
||||||
<p>All mail users are stored in SQL table <code>vmail.mailbox</code>, user password is stored
|
|
||||||
in SQL column <code>mailbox.password</code>. For example:</p>
|
|
||||||
<pre>
|
|
||||||
sql> UPDATE mailbox SET password='$1$GfHYI7OE$vlXqMZSyJOSPXAmbXHq250' WHERE username='xx@xx';
|
|
||||||
sql> UPDATE mailbox SET password='{SSHA}OuCrqL2yWwQIu8a9uvyOQ5V/ZKfL7LJD' WHERE username='xx@xx';
|
|
||||||
sql> UPDATE mailbox SET password='{SSHA512}FxgXDhBVYmTqoboW+ibyyzPv/wGG7y4VJtuHWrx+wfqrs/lIH2Qxn2eA0jygXtBhMvRi7GNFmL++6aAZ0kXpcy1fxag=' WHERE username='xx@xx';
|
|
||||||
</pre>
|
|
||||||
|
|
||||||
<ul>
|
|
||||||
<li>To store PLAIN-MD5, you have to prepend <code>{PLAIN-MD5}</code> in your password hash:</li>
|
|
||||||
</ul>
|
|
||||||
<pre>
|
|
||||||
sql> UPDATE mailbox SET password='{PLAIN-MD5}0d2bf3c712402f428d48fed691850bfc' WHERE username='xx@xx';
|
|
||||||
</pre>
|
|
||||||
|
|
||||||
<ul>
|
|
||||||
<li>To store plain password, you have to prepend <code>{PLAIN}</code>:
|
|
||||||
<pre>sql> UPDATE mailbox SET password='{PLAIN}123456' WHERE username='xx@xx';</pre></li>
|
|
||||||
</ul>
|
|
||||||
<h3 id="for-ldap-backends">For LDAP backends</h3>
|
|
||||||
<p>User password is stored in attribute <code>userPassword</code> of user object.</p>
|
|
||||||
<ul>
|
|
||||||
<li>
|
|
||||||
<p>To store plain password, SSHA, SSHA512 password hash, just store them in
|
|
||||||
original format. For example:
|
|
||||||
<pre>
|
|
||||||
userPassword: 123456
|
|
||||||
userPassword: {SSHA}OuCrqL2yWwQIu8a9uvyOQ5V/ZKfL7LJD
|
|
||||||
userPassword: {SSHA512}FxgXDhBVYmTqoboW+ibyyzPv/wGG7y4VJtuHWrx+wfqrs/lIH2Qxn2eA0jygXtBhMvRi7GNFmL++6aAZ0kXpcy1fxag=</pre></p>
|
|
||||||
</li>
|
|
||||||
<li>
|
|
||||||
<p>To store standard MD5 password (salted MD5 hash), please prepend <code>{CRYPT}</code>
|
|
||||||
(case insensitive) in your password hash. For example:
|
|
||||||
<pre>userPassword: {CRYPT}$1$GfHYI7OE$vlXqMZSyJOSPXAmbXHq250</pre></p>
|
|
||||||
</li>
|
|
||||||
</ul>
|
|
||||||
<p><strong>IMPORTANT NOTE</strong>: If you want to input password hash with phpLDAPadmin,
|
|
||||||
please choose <code>clear</code> in the password hash list, then input password hash.</p></body></html>
|
|
|
@ -0,0 +1,38 @@
|
||||||
|
<html>
|
||||||
|
<head>
|
||||||
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||||||
|
<title> Why append timestamp in maildir path</title>
|
||||||
|
<link href="../css/markdown.css" rel="stylesheet"></head>
|
||||||
|
</head>
|
||||||
|
|
||||||
|
<body>
|
||||||
|
<h1 id="why-append-timestamp-in-maildir-path">Why append timestamp in maildir path</h1>
|
||||||
|
<p>iRedMail will append timestamp in maildir path by default, here's why.</p>
|
||||||
|
<p>Depends on the tools/scripts you used to create mail accounts, it's tunable
|
||||||
|
in scripts shipped within iRedMail and iRedAdmin (file <code>settings.py</code>, variable
|
||||||
|
<code>MAILDIR_APPEND_TIMESTAMP = True</code> or `False').</p>
|
||||||
|
<p>Deleting mail accounts with iRedAdmin will not remove the mailboxes on file
|
||||||
|
system, so that you can keep user's mailbox for some time.</p>
|
||||||
|
<p>Think about this situation:</p>
|
||||||
|
<ul>
|
||||||
|
<li>
|
||||||
|
<p>Employee Michael Jordan has email address mj@domain.ltd. Without timestamp
|
||||||
|
in maildir path, the maildir path of his mailbox looks like
|
||||||
|
<code>/var/vmail/vmail1/domain.ltd/mj/</code>.</p>
|
||||||
|
</li>
|
||||||
|
<li>
|
||||||
|
<p>Michael left company, and your company deleted his mail account. With
|
||||||
|
iRedAdmin, it just deletes mail accounts stored in LDAP/SQL server, not delete
|
||||||
|
his mailbox on file system (<code>var/vmail/vmail1/domain.ltd/mj</code>).</p>
|
||||||
|
</li>
|
||||||
|
<li>
|
||||||
|
<p>A new talent joined in, his name is Mike Jackson, and he want to use
|
||||||
|
<code>mj@domain.ltd</code> since <code>mj@</code> is not used by others. And you created it for him.
|
||||||
|
Without timestamp in maildir path, the maildir path of Mike's mailbox is the
|
||||||
|
same as Michael's <code>/var/vmail/vmail1/domain.ltd/mj/</code>.</p>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
<p>iRedAdmin doesn't remove the mailboxes on file system, so Mike will see all
|
||||||
|
emails in Michael's mailbox if Michael didn't delete them. To avoid this, we
|
||||||
|
append a timestamp in maildir path to make sure all users will be assigned
|
||||||
|
a unique maildir paths.</p></body></html>
|
|
@ -1,26 +1,30 @@
|
||||||
<html>
|
<html>
|
||||||
<head>
|
<head>
|
||||||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||||||
<title></title>
|
<title>iRedMail Documentations</title>
|
||||||
<link href="./css/markdown.css" rel="stylesheet"></head>
|
<link href="./css/markdown.css" rel="stylesheet"></head>
|
||||||
</head>
|
</head>
|
||||||
|
|
||||||
<body>
|
<body>
|
||||||
<h1 id="frequently-asked-questions-and-howto-documents">Frequently Asked Questions and Howto documents</h1>
|
<h1 id="frequently-asked-questions">Frequently Asked Questions</h1>
|
||||||
<ul>
|
<ul>
|
||||||
<li><a href="faq-howto/allow.user.to.send.email.without.authentication.html"> How to allow user to send email without authentication
|
|
||||||
</a></li>
|
|
||||||
<li><a href="faq-howto/amavisd.no.x-spam.headers.html"> Amavisd + SpamAssassin not working, no mail header (X-Spam-*) inserted.</a></li>
|
|
||||||
<li><a href="faq-howto/completely.disable.amavisd.clamav.spamassassin.html"> How to completely disable amavisd/ClamAV/SpamAssassin</a></li>
|
|
||||||
<li><a href="faq-howto/disable.spam.virus.scanning.for.outgoing.mails.html"> How to disable spam virus scanning for outgoing mails</a></li>
|
|
||||||
<li><a href="faq-howto/howto.configure.thunderbird.for.iredmail.html"> Configure Thunderbird as mail client (IMAP, SMTP and global ldap address book)</a></li>
|
|
||||||
<li><a href="faq-howto/howto.enable.smtps.service.html"> How to enable SMTPS service (SMTP over SSL, port 465)</a></li>
|
|
||||||
<li><a href="faq-howto/pipe.incoming.email.for.certain.user.to.external.script.html"> How to pipe incoming email for certain user to external script </a></li>
|
|
||||||
<li><a href="faq-howto/recalculate.mailbox.quota.html"> How to force Dovecot to recalculate mailbox quota
|
|
||||||
</a></li>
|
|
||||||
<li><a href="faq-howto/store.spamassassin.bayes.in.sql.html"> How to store spamassassin bayes in SQL</a></li>
|
|
||||||
<li><a href="faq-howto/unattended.iredmail.installation.html"> How to perform silent/unattended iRedMail installation</a></li>
|
|
||||||
<li><a href="faq-howto/use.or.migrate.password.hashes.html"> How to use or migrate password hashes</a></li>
|
<li><a href="faq-howto/use.or.migrate.password.hashes.html"> How to use or migrate password hashes</a></li>
|
||||||
|
<li><a href="faq-howto/why.append.timestamp.in.maildir.path.html"> Why append timestamp in maildir path</a></li>
|
||||||
|
</ul>
|
||||||
|
<h1 id="how-to">How to</h1>
|
||||||
|
<ul>
|
||||||
|
<li><a href="howto/allow.user.to.send.email.without.authentication.html"> How to allow user to send email without authentication
|
||||||
|
</a></li>
|
||||||
|
<li><a href="howto/amavisd.no.x-spam.headers.html"> Amavisd + SpamAssassin not working, no mail header (X-Spam-*) inserted.</a></li>
|
||||||
|
<li><a href="howto/completely.disable.amavisd.clamav.spamassassin.html"> How to completely disable amavisd/ClamAV/SpamAssassin</a></li>
|
||||||
|
<li><a href="howto/disable.spam.virus.scanning.for.outgoing.mails.html"> How to disable spam virus scanning for outgoing mails</a></li>
|
||||||
|
<li><a href="howto/howto.configure.thunderbird.for.iredmail.html"> Configure Thunderbird as mail client (IMAP, SMTP and global ldap address book)</a></li>
|
||||||
|
<li><a href="howto/howto.enable.smtps.service.html"> How to enable SMTPS service (SMTP over SSL, port 465)</a></li>
|
||||||
|
<li><a href="howto/pipe.incoming.email.for.certain.user.to.external.script.html"> How to pipe incoming email for certain user to external script </a></li>
|
||||||
|
<li><a href="howto/recalculate.mailbox.quota.html"> How to force Dovecot to recalculate mailbox quota
|
||||||
|
</a></li>
|
||||||
|
<li><a href="howto/store.spamassassin.bayes.in.sql.html"> How to store spamassassin bayes in SQL</a></li>
|
||||||
|
<li><a href="howto/unattended.iredmail.installation.html"> How to perform silent/unattended iRedMail installation</a></li>
|
||||||
</ul>
|
</ul>
|
||||||
<h1 id="backup-and-restore">Backup and Restore</h1>
|
<h1 id="backup-and-restore">Backup and Restore</h1>
|
||||||
<ul>
|
<ul>
|
||||||
|
|
|
@ -0,0 +1,19 @@
|
||||||
|
|
||||||
|
# Frequently Asked Questions
|
||||||
|
* [ How to use or migrate password hashes](faq-howto/use.or.migrate.password.hashes.html)
|
||||||
|
* [ Why append timestamp in maildir path](faq-howto/why.append.timestamp.in.maildir.path.html)
|
||||||
|
# How to
|
||||||
|
* [ How to allow user to send email without authentication
](howto/allow.user.to.send.email.without.authentication.html)
|
||||||
|
* [ Amavisd + SpamAssassin not working, no mail header (X-Spam-*) inserted.](howto/amavisd.no.x-spam.headers.html)
|
||||||
|
* [ How to completely disable amavisd/ClamAV/SpamAssassin](howto/completely.disable.amavisd.clamav.spamassassin.html)
|
||||||
|
* [ How to disable spam virus scanning for outgoing mails](howto/disable.spam.virus.scanning.for.outgoing.mails.html)
|
||||||
|
* [ Configure Thunderbird as mail client (IMAP, SMTP and global ldap address book)](howto/howto.configure.thunderbird.for.iredmail.html)
|
||||||
|
* [ How to enable SMTPS service (SMTP over SSL, port 465)](howto/howto.enable.smtps.service.html)
|
||||||
|
* [ How to pipe incoming email for certain user to external script ](howto/pipe.incoming.email.for.certain.user.to.external.script.html)
|
||||||
|
* [ How to force Dovecot to recalculate mailbox quota
](howto/recalculate.mailbox.quota.html)
|
||||||
|
* [ How to store spamassassin bayes in SQL](howto/store.spamassassin.bayes.in.sql.html)
|
||||||
|
* [ How to perform silent/unattended iRedMail installation](howto/unattended.iredmail.installation.html)
|
||||||
|
# Backup and Restore
|
||||||
|
* [How to migrate old iRedMail server to the latest stable release](backup-restore/migrate.to.new.iredmail.server.html)
|
||||||
|
# Troubleshooting and Debug
|
||||||
|
* [ How to turn on debug mode in Dovecot](troubleshooting/turn.on.debug.mode.in.dovecot.html)
|
|
@ -1,23 +0,0 @@
|
||||||
<html>
|
|
||||||
<head>
|
|
||||||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
||||||
<title> How to turn on debug mode in Dovecot</title>
|
|
||||||
<link href="../css/markdown.css" rel="stylesheet"></head>
|
|
||||||
</head>
|
|
||||||
|
|
||||||
<body>
|
|
||||||
<h1 id="how-to-turn-on-debug-mode-in-dovecot">How to turn on debug mode in Dovecot</h1>
|
|
||||||
<p>To turn on debug mode in Dovecot, please update Dovecot config file
|
|
||||||
<code>/etc/dovecot/dovecot.conf</code> (Linux/OpenBSD) or
|
|
||||||
<code>/usr/local/etc/dovecot/dovecot.conf</code> (FreeBSD), set <code>mail_debug</code> to <code>yes</code>:</p>
|
|
||||||
<pre><code>mail_debug = yes
|
|
||||||
</code></pre>
|
|
||||||
|
|
||||||
<p>Restart Dovecot service.</p>
|
|
||||||
<p>If you need authentication and password related debug message, turn on related
|
|
||||||
settings and restart dovecot service.</p>
|
|
||||||
<pre><code>auth_verbose = yes
|
|
||||||
auth_debug = yes
|
|
||||||
auth_debug_passwords = yes
|
|
||||||
auth_verbose_passwords = yes
|
|
||||||
</code></pre></body></html>
|
|
Loading…
Reference in New Issue