Migration Tip: If you already have iRedAdmin open source edition installed, you can simply migrate it to iRedAdmin-Pro.

System Requirements.

  • Apache, 2.2+. Web server.
    • mod_wsgi 2.1+. Apache module used to host Python application which supports the Python WSGI interface.
  • Python 2.4+, core programming language. Warning: Python 3.x is not supported yet.
    • Web.py, 0.32+. A python-powered web framework.
    • MySQLdb. A thread-compatible interface to the popular MySQL database server that provides the Python database API.
    • Python-LDAP, 2.3.7+. An object-oriented API to access LDAP directory servers from Python programs.
  • Download iRedAdmin from download page.
  • Copy iRedAdmin to /var/www/, set correct file permissions, and create symbol link.
  • # tar xjf iRedAdmin-x.y.z.tar.bz2 -C /var/www/
    # cd /var/www/
    # chown -R iredadmin:iredadmin iRedAdmin-x.y.z
    # chmod -R 0555 iRedAdmin-x.y.z
    # ln -s iRedAdmin-x.y.z iredadmin
    
  • Add apache configure file: /etc/httpd/conf.d/iredadmin.conf.
  • #
    # Note: Uncomment below two lines if you want to make iRedAdmin accessible via HTTP.
    #
    #WSGIScriptAlias /iredadmin /var/www/iredadmin/iredadmin.py/
    #Alias /iredadmin/static /var/www/iredadmin/static/
    
    WSGISocketPrefix /var/run/wsgi
    WSGIDaemonProcess iredadmin user=iredadmin threads=15
    WSGIProcessGroup iredadmin
    
    AddType text/html .py
    
    <Directory /var/www/iredadmin/>
        Order deny,allow
        Allow from all
    </Directory>
  • Edit /etc/httpd/conf.d/ssl.conf, make iredadmin accessible via HTTPS. Add below lines before </VirtualHost>:
  • WSGIScriptAlias /iredadmin /var/www/iredadmin/iredadmin.py/
    Alias /iredadmin/static /var/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 /var/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 /var/www/iredadmin/
    # cp settings.py.ldap.sample settings.py
    # chown iredadmin:iredadmin settings.py
    # chmod 0400 settings.py
    
  • Update settings.py with correct values (LDAP bind dn/password, etc).
    • NOTE: For more inforamtion, please read settings.py, 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
  • Restart apache web server.
  • # /etc/init.d/httpd restart
    

Open your web browser to access iRedAdmin.

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

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

Troubleshooting & Debug

If iRedAdmin doesn't work as expected, you can simplily set 'debug = True' in settings.py, restart apache web server, use your favourite web browser to access it again, create a new forum topic and paste error message in forum topic.