iRedMail
// Document IndexiRedMail Easy is a web-based platform for iRedMail deployment, upgrade, and technical support. With this platform, it's easy to deploy and keep the iRedMail servers up to date, easy to get the fast and professional technical support from iRedMail team.
We encourage all users to deploy new iRedMail servers with this platform and keep the servers up to date.
If you prefer classic downloadable iRedMail installer, you can find the installation guides here: Install iRedMail.
Warning
iRedMail is designed to be deployed on a dedicate server, which means you can not have other network services running on the server BEFORE iRedMail installation.
iRedMail will install and configure all required softwares automatically.
Linux/BSD distribution releases supported by iRedMail Easy:
| Distribution | Release Versions |
|---|---|
| CentOS | 7 |
| Debian | 9 |
| Ubuntu | 16.04, 18.04 |
| OpenBSD | 6.4 |
If you need to install iRedMail on FreeBSD, please follow the installation guide below:
2 GB memory for a low traffic production server.To deploy a mail server, you need to sign up and login with a valid email address first:
We will send you an email to confirm you're the owner of the email address, please click the link in the email to confirm, then login.
After signed up, you get one-month trial to evaluate this web deployment
platform, if you don't like or need it, feel free to remove your own account in
Profile page after login.
Screenshots of login and sign up web pages:
After login, you will be redirected to the Dashboard page, please click the
Add a mail server button to add a new mail server.
Explanation of the form fields (screenshots attached below):
Hostname (FQDN): This is the server hostname you want to set for the mail server.
mail.example.com, mx.example.com.user@example.com) because it's used to accept email sent
to Linux/BSD system account like root user.IP Address: Public or private IP address of your mail server.
If this mail server is in internal network and can not be accessed directly from external network, you need a Jump Server (or, Bastion Server) so that our deployment server can connect to your mail server. For more details about Jump Server, please read this short tutorial: What is SSH jump server.
SSH Port: SSH service port number. Defaults to 22.
SSH User: The login username for ssh secure connection. Defaults to root.
If you use a non-root user, sudo on Linux or doas on OpenBSD is
required to gain root privilege.
SSH Key: The SSH key used to login to your mail server.
If you choose option Generate one for me, after submitted this form,
our system will generate a strong (4096 bits) SSH key for you.
OS: Choose the Linux/BSD distribution and release version of your mail server.
Deployment Server: Please choose one deployment server.
Deployment server connects to your mail server to deploy or upgrade, please choose the nearest one for faster network connection.
If your mail server sits behind a firewall, please whitelist the IP address of selected deployment server.
Comment: Add some text to help you identify this mail server.
Screenshots:
After added mail server, you will be redirected to mail server profile page. There're few tabs on the page, let's go through them one by one. Screenshot attached below.
Tab (mail server) Profile.
We already filled all form fields while creating it, you're free to update them here.
Tab Backend.
A backend is a SQL or LDAP database used to store mail domains and accounts. We suggest you choose the one you're familiar with for easier maintaince.
Tab Components.
A component is a software (or software group) used by mail service. On this page you can choose the components you want to deploy on your mail server.
Tab Settings.
Depends on the components you selected, the settings on this page may be different. Please fill all required form fields on this page.
Fields with red asterisk are required, others are optional.
Tab Deployment.
The deployment server will run Ansible to connect to your mail server via
secure ssh connection, without a password. Please download the prepared
script and upload it to the mail server, then run it with command below. it will help add ssh public key and
set correct file permission. If ssh login user is not root, it will help
setup sudo (on Linux) or doas (on OpenBSD).
bash init_target_server.sh
After you added ssh public key, click the button Perform Full Deployment
to start the iRedMail deployment.
Depends on the components you selected, and network connection speed, it may take few minutes or even longer to finish. Please be patient.
If you have any question or issue, feel free to open a new support ticket, clearly explain the question or issue, support team will try to reply in time.
You can update your name, time zone, password on the Profile page. If you
do not like this platform, you're free to remove your account here too.
