diff --git a/README.md b/README.md index ac0325c9..200d3728 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,6 @@ * Documents are all licensed under [Creative Commons](http://creativecommons.org/). # Install iRedMail +* [Install iRedMail on Debian Linux](https://bitbucket.org/zhb/docs.iredmail.org/src/default/installation/install.iredmail.on.debian.md) * [Install iRedMail on Red Hat Enterprise Linux, CentOS](https://bitbucket.org/zhb/docs.iredmail.org/src/default/installation/install.iredmail.on.rhel.md) * [Setup DNS records for your iRedMail server](https://bitbucket.org/zhb/docs.iredmail.org/src/default/installation/setup_dns.md) * [Perform silent/unattended iRedMail installation](https://bitbucket.org/zhb/docs.iredmail.org/src/default/installation/unattended.iredmail.installation.md) diff --git a/TODO.md b/TODO.md index e836e553..cd870263 100644 --- a/TODO.md +++ b/TODO.md @@ -4,8 +4,8 @@ * How to enable per-recipient policy lookup in Amavisd (@lookup_sql_dsn). * How to enable DNSBL in Postfix. -* How to sign DKIM signature on sent emails for new mail domain. mention how - to use one DKIM key for all domains. +* ~~ How to sign DKIM signature on sent emails for new mail domain. mention how + to use one DKIM key for all domains. ~~ # installation guides diff --git a/html/index.html b/html/index.html index ee91b330..ee4da66d 100644 --- a/html/index.html +++ b/html/index.html @@ -14,6 +14,7 @@
++WARNING: iRedMail is designed to be deployed on a FRESH server system, +which means your server does NOT have mail related components installed, +e.g. MySQL, OpenLDAP, Postfix, Dovecot, Amavisd, etc. iRedMail will install +and configure them for you automatically. Otherwise it may override your +existing files/configurations althought it will backup files before modifing, +and it may be not working as expected.
+
To install iRedMail on Debian Linux, you need:
+1 GB
of memory is required for low traffic production server.
+ Spam/Virus scanning will take most system resource.Note: All binary packages will be installed from Debian official apt repositories.
+No matter your server is a testing machine or production server, it's strongly +recommended to set a fully qualified domain name (FQDN) hostname.
+Enter command hostname -f
to view the current hostname:
$ hostname -f
+mx.example.com
+
+
+On Debian, hostname is set in two files: /etc/hostname
and /etc/hosts
.
/etc/hostname
: short hostname, not FQDN.mx
+
+
+/etc/hosts
: static table lookup for hostnames. Warning: Please list the
+ FQDN hostname as first item.# Part of file: /etc/hosts
+127.0.0.1 mx.example.com mx localhost localhost.localdomain
+
+
+Verify the FQDN hostname. If it wasn't changed after updating above two files, +please reboot server to make it work.
+$ hostname -f
+mx.example.com
+
+
+/etc/apt/sources.lists
.bzip2
so that you can uncompress downloaded iRedMail package.# sudo apt-get install bzip2
+
+
+Visit Download page to get the + latest stable release of iRedMail.
+Upload iRedMail to your mail server via ftp or scp or whatever method you
+ can use, login to the server to install iRedMail. We assume you uploaded
+ it to /root/iRedMail-x.y.z.tar.bz2
(replace x.y.z by the real version number).
Uncompress iRedMail tarball:
+# cd /root/
+# tar xjf iRedMail-x.y.z.tar.bz2
+
+
+It's now ready to start iRedMail installer, it will ask you several simple +questions, that's all steps to setup a full-featured mail server.
+++For Chinese users: Our domain name "iredmail.org" is blocked in China mainland since Jun 04, 2011, please replace all 'iredmail.org' by its IP address "106.187.51.47" (without quotes) in /root/iRedMail-x.y.z/pkgs/get_all.sh BEFORE executing "iRedMail.sh". This is a Linode VPS hosted in Tokyo, Japan.
+
# cd /root/iRedMail-x.y.z/
+# bash iRedMail.sh
+
+
+/var/vmail/
.IMPORTANT NOTE: There's no big difference between available backends, so +it's strongly recommended to choose the one you're familiar with for easier +management and maintenance after installation.
+ +LDAP suffix.
+ +Password of LDAP root dn.
+ +NOTE: MySQL is used to store data of other applications (e.g. Roundcube +webmail, Cluebringer, Amavisd-new) if you choose OpenLDAP or MySQL as backend.
+ +Note: This account is an admin account and a mail user. That means you can +login to webmail and admin panel (iRedAdmin) with this account, login username +is full email address.
+ +After answered above questions, iRedMail installer will ask your confirm to
+start installation. It will install and configure required packages
+automatically. Type y
or Y
and press Enter
to start.
Configuration completed.
+
+*************************************************************************
+**************************** WARNING ***********************************
+*************************************************************************
+* *
+* Please do remember to *REMOVE* configuration file after installation *
+* completed successfully. *
+* *
+* * /root/iRedMail-x.y.z/config
+* *
+*************************************************************************
+<<< iRedMail >>> Continue? [Y|n] # <- Type 'Y' or 'y' here, and press 'Enter' to continue
+
+
+Read file /root/iRedMail-x.y.z/iRedMail.tips
first, it contains:
After installation successfully completed, you can access web-based programs
+if you choose to install them. Replace your_server
below by your real server
+hostname or IP address.
Please post all issues, feedbacks, feature requests, suggestions in our online +support forum, it's more responsible than you +expected.
+Most binary packages in iRedMail yum repository comes from below repositories,
+packages with -ired
flag were packed by iRedMail project.
If you found something wrong +in this document, please do +contact us to fix it.
©© Creative Commons