iRedMail - Free, Open Source Email Server Solution

If you already purchased iRedAdmin-Pro, you should already get it ready for install. If not, mail to support@ iredmail.org to get one.

• Download iRedAdmin from download page.
• Copy iRedAdmin to /srv/www/, set correct file permissions, and create symbol link.

# tar xjf iRedAdmin-x.y.z.tar.bz2 -C /srv/www/
# cd /srv/www/
# chown -R iredadmin iRedAdmin-x.y.z
# chmod -R 0555 iRedAdmin-x.y.z
# ln -s iRedAdmin-x.y.z iredadmin

• Add apache configure file: /etc/apache2/conf.d/iredadmin.conf.

#
# Note: Uncomment below two lines if you want to make iRedAdmin accessible via HTTP.
#
#WSGIScriptAlias /iredadmin /srv/www/iredadmin/iredadmin.py/
#Alias /iredadmin/static /srv/www/iredadmin/static/

WSGISocketPrefix /var/run/wsgi
WSGIDaemonProcess iredadmin user=iredadmin threads=15
WSGIProcessGroup iredadmin

AddType text/html .py

<Directory /srv/www/iredadmin/>
    Order deny,allow
    Allow from all
</Directory>

• Edit /etc/httpd/vhosts.d/vhost-ssl.conf, make iredadmin accessible via HTTPS. Add below lines before </VirtualHost>:

WSGIScriptAlias /iredadmin /srv/www/iredadmin/iredadmin.py/
Alias /iredadmin/static /srv/www/iredadmin/static/

• Restart apache to enable mod_wsgi:

# /etc/init.d/httpd restart

• Create MySQL database: iredadmin.

# mysql -uroot -p
mysql> CREATE DATABASE iredadmin DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
mysql> USE iredadmin;
mysql> SOURCE /srv/www/iredadmin/docs/samples/iredadmin.sql;

• Grant privileges to iredadmin user and set password for it.
WARNING: Here we use 'secret_passwd' as password of iredadmin user, please replace it with your own password.

# mysql -uroot -p
mysql> GRANT SELECT,INSERT,UPDATE,DELETE ON iredadmin.* TO iredadmin@localhost IDENTIFIED BY 'secret_passwd';
mysql> FLUSH PRIVILEGES;

• Copy example config file, and make it not world-writeable.

# cd /srv/www/iredadmin/
# cp settings.ini.ldap.sample settings.ini
# chown iredadmin settings.ini
# chmod 0400 settings.ini

• Edit settings.ini and set several variables.
• NOTE: For more inforamtion, please read settings.ini, it's self-documented.
• NOTE: You should ensure both bind dn and bind_pw are correct with below command, you can find bind dn and password in your iRedMail installation directory, e.g. /root/iRedMail-0.5.1/iRedMail.tips, usually, it's cn=vmailadmin,dc=xxx,dc=xxx.

# ldapsearch -x -D 'YOUR_BIND_DN' -W

[general]
admin = user@domain.ltd
debug = False
lang = en_US
backend = ldap
storage_base_directory = /var/vmail/vmail1

[iredadmin]
dbn = mysql
host = localhost
port = 3306
db = iredadmin
user = iredadmin
passwd = secret_passwd

[ldap]
uri = ldap://127.0.0.1:389
suffix = dc=iredmail,dc=org
basedn = o=domains,dc=iredmail,dc=org
domainadmin_dn = o=domainAdmins,dc=iredmail,dc=org
bind_dn = cn=vmailadmin,dc=iredmail,dc=org
bind_pw = passwd

[policyd]
# ---- This section is available in iRedAdmin-Pro-1.3.0. ----
# Policyd integration.
# For server-wide white-/blacklist and sender/recipient throttling.
enabled = True

dbn = mysql
host = localhost
port = 3306
db = policyd
user = policyd
passwd = passwd

[amavisd]
# ---- This section is available in iRedAdmin-Pro >= 1.4.0. ----

• Restart apache web server.

# /etc/init.d/apache2 restart

Open your web browser to access iRedAdmin: httpS://your_server_ip_address/iredadmin/

Make sure you use HTTPS:// instead of HTTP://.