# Install iRedMail Enterprise Edition

Attention

Check out the lightweight on-premises email archiving software developed by iRedMail team: Spider Email Archiver.

Attention

- All account passwords are generated randomly during deployment, stored in files under `/root/.iredmail/kv/` on your server, also organized in file `/root/iRedMail/iRedMail.tips`.
- To migrate your existing iRedMail server to iRedMail Enterprise Edition, please check this tutorial: Migrate from iRedMail to iRedMail Enterprise Edition.

## Summary

iRedMail Enterprise Edition is a web-based, on-premises iRedMail server installer and management admin panel.

With iRedMail Enterprise, it's easy to deploy a full-featured email server, and keep the server up to date with just few clicks on the web UI, also manage or tune server settings.

We encourage all users to deploy new iRedMail servers with iRedMail Enterprise Edition and keep the server up to date.

If you prefer classic downloadable shell-based iRedMail installer, you can find the installation guides here: Install iRedMail.

## System Requirements

Warning

- iRedMail Enterprise Edition is designed to be deployed on a fresh / clean server, which means you should not have other network services running on the server BEFORE iRedMail installation.
- iRedMail Enterprise Edition will install and configure all required software automatically.

- Many ISPs block network port 25 by default, it's used for communication between mail servers and it must be open, otherwise your server may be not able to receive or / and send emails. Please contact your ISP to make sure it's not blocked, or ask them to unblock.

  - Amazon AWS EC2. Request to remove the throttle on port 25.
  - Google Cloud Platform.
  - Microsoft Azure.
  - Linode. Explained in the blog post, you can open a support ticket to request the Linode team to open it. If you sign up to Linode with our reference, iRedMail Team's Linode account will receive a credit of $15-20.00. Thanks.
  - DigitalOcean. According to a post in their community, SEEMS impossible to unblock port 25, that means you can NOT run mail server on DigitalOcean VPS.

### Supported Linux and BSD distribution releases

Linux/BSD distribution releases supported by iRedMail Enterprise Edition:

Distribution | Release Versions
--- | ---
CentOS Stream | 8, 9
Rocky Linux | 8, 9
AlmaLinux | 8, 9
Debian | 11, 12
Ubuntu | 18.04, 20.04, 22.04
OpenBSD | 7.3

If you need to install iRedMail on FreeBSD, please use the downloadable installer instead.

### Hardware Requirements

- iRedMail requires at least `4 GB` memory for a low traffic production server with spam/virus scanning enabled.
- If you plan to run SOGo Groupware (which offers webmail, calendar (CalDAV), contacts (CardDAV) and ActiveSync), you need a lot more memory. Consider 16 GB memory to support 500 ActiveSync clients.

## Get a License (OPTIONAL)

iRedMail Enterprise works without a license, but more features are available with a valid license.

You can sign up or login to iRedMail Store to either request a free trial license or purchase one.

## Download and run the installer

Run commands below on the server to download iRedMail Enterprise for Linux (amd64 / x86_64):

Attention

Please download it and save to `/usr/local/bin/iredmail`. This path is hard-coded in systemd service file to start iRedMail Enterprise.

    wget -O /usr/local/bin/iredmail https://dl.iredmail.org/iredmail-enterprise-v1.0-beta3-linux-amd64
    chmod +x /usr/local/bin/iredmail

Launch the installer:

    /usr/local/bin/iredmail

- It runs a web server on port `8080` for initial deployment, please visit `http://your-server:8080` with your favourite web browser and go through the wizard to finish the installation.
- After deployment succeeded, it closes port `8080` and runs on port `127.0.0.1:7793`. Nginx is configured to proxy requests to it through URI `/admin/` (this URI can be customized on web UI during installation), please visit `httpS://your-server/admin/` to access it to manage your iRedMail server.

Below are screenshots of the installation wizard.

## Installation

### Choose preferred backend

A backend is a SQL or LDAP database used to store mail domains and accounts. There're not big differences between them, so we suggest you choose the one you're familiar with for easier maintenance.

### Choose the components you want to deploy

A component is a software (or software group, service) which implements some network service(s). On this page you can choose the components you want to deploy on your mail server.

### Required settings

Few settings are required to deploy a mail server.

Note: while typing, it will validate the input value, please fill and wait for 1-3 seconds until it finished the validation.

### Optional settings

Depends on the components you chose to install, the settings on this page may be different.

### Review and deploy

Attention

All account passwords are generated randomly during deployment, and stored in files under `/root/.iredmail/kv/` on your own server, also organized in file `/root/iRedMail/iRedMail.tips` for your reference.

Review the settings:

Click `Confirm and Deploy` button to deploy immediately:

### Setup complete

Once setup finished successfully, you should see info for login to admin panel. Please visit the URL and login with given username and password.

Note: This is a global admin which has all privileges.

### Login to admin panel

After logged into admin panel, you can manage software components, tune server settings, manage mail accounts, etc.

## See Also

- Setup DNS records for your iRedMail server
- Request a free cert from Let's Encrypt
- Configure mail client applications