Installation

Home

There are many different senarios that you can install mail-admin. The recomended way is to use iRedmail to install your mailserver. But install iRedMail with no web server.

Even know mail-admin was originally designed to work on top of iRedmail, it is not excusive. mail-admin will work with any postifx/dovecot install that uses an LDAP backend. However, you may need to spend more time configuring.

Install for use with iRedMail (recomended)

iRedMail install with no existing web server installed

When you install iRedMail, make sure that you install with no web server to follow these instructions.

sudo apt install -y lsb-release ca-certificates apt-transport-https software-properties-common
echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/sury-php.list
wget -qO - https://packages.sury.org/php/apt.gpg | sudo apt-key add -
sudo apt update
sudo apt install apache2 php8.0 php8.0-ldap git -y
cd /var/www/html
wget https://github.com/johnhart96/mail-admin/archive/refs/tags/1.0.zip
unzip mail-admin-1.0.zip
mv mail-admin-1.0 mail-admin
sudo cp /var/www/html/mail-admin/usr/config.sample.php /var/www/html/mail-admin/usr/config.php

Then edit /var/www/html/mail-admin/usr/config.php and add your LDAP details that you find in ~/iRedmail-xx/iRedMail.tips

iRedMail with Nginx

This install method assumes that you have already installed the iRedMail control panel using Nginx.

cd /var/www/html
wget https://github.com/johnhart96/mail-admin/archive/refs/tags/1.0.zip
unzip mail-admin-1.0.zip
mv mail-admin-1.0 mail-admin
sudo cp /var/www/html/mail-admin/usr/config.sample.php /var/www/html/mail-admin/usr/config.php

Then edit /var/www/html/mail-admin/usr/config.php and add your LDAP details that you find in ~/iRedmail-xx/iRedMail.tips