5.1 KiB
Migrate from iRedMail to iRedMail Easy platform
[TOC]
!!! attention
iRedMail Team can help migrate your iRedMail server, feel free to
[Contact Us](https://www.iredmail.org/contact.html).
Summary
iRedMail Easy platform offers deployment, one-click upgrade support and technical support for your iRedMail servers, it's very easy to keep your server up to date with the ease to use web UI, and get issues solved by iRedMail Team quickly.
For more details about iRedMail Easy platform, please check our website.
Requirements
- A working iRedMail server which was deployed with the downlodable installer
iRedMail-0.9.9
, or has been successfully upgraded to the latest iRedMail-0.9.9 release. - Your iRedMail server must be running one of supported Linux/OpenBSD
distribution releases:
- Ubuntu 18.04 LTS
- Debian 9
- CentOS 7
- OpenBSD 6.4, 6.5
Unfortunately, FreeBSD is not supported by iRedMail Easy platform.
Create required files used by iRedMail Easy
iRedMail Easy doesn't store any SQL/LDAP passwords, instead it reads from files
under /root/.iredmail/kv/
on your server to get them.
Please create these files under /root/.iredmail/kv/
with correct passwords
manually, each file should contain only one line, passwords must be in plain
text, not the hashed one.
!!! attention
You can find all info in the `iRedMail.tips` file under iRedMail
installation directory, for example, `/root/iRedMail-0.9.9/iRedMail.tips`.
If you don't have this file anymore, you can still find them in other
config files.
mysql_root_password
: the MySQL root password. This is required for OpenLDAP and MySQL/MariaDB backends. You can find it in file/root/.my.cnf
or/root/.my.cnf-root
.pgsql_root_password
: The PostgreSQL root password. This is required for PostgreSQL backend. You can find it in the.pgpass
file under PostgreSQL data directory.- on CentOS, it's
/var/lib/pgsql/.pgpass
. - on Debian/Ubuntu, it's
/var/lib/postgresql/.pgpass
. - on OpenBSD, it's
/var/postgresql/.pgpass
.
- on CentOS, it's
ldap_root_password
: The password of OpenLDAP root dn (cn=Manager,dc=xx,dc=xx). This is required for OpenLDAP backend.ldap_vmail_password
: The password of LDAP dncn=vmail,dc=xx,dc=xx
.ldap_vmailadmin_password
: The password of LDAP dncn=vmailadmin,dc=xx,dc=xx
.vmail_db_password
: The password of SQL uservmail
.vmail_db_admin_password
: The password of SQL uservmailadmin
.amavisd_db_password
: The password of SQL useramavisd
.sa_bayes_db_password
: The password of SQL usersa_bayes
.iredadmin_db_password
: The password of SQL useriredadmin
.iredapd_db_password
: The password of SQL useriredapd
.iredapd_srs_secret
: The secret string used by iRedAPD to sign SRS.sogo_db_password
: The password of SQL usersogo
.sogo_sieve_master_password
: The Dovecot master user used by SOGo. You can find it in/etc/sogo/sieve.cred
.roundcube_db_password
: The password of SQL userroundcube
.roundcube_des_key
: The DES key used by Roundcube to encrypt the session. You can find it in/opt/www/roundcubemail/config/config.inc.php
, parameter$config['des_key'] =
.mlmmjadmin_api_token
: The token string used by iRedAdmin-Pro to communicate with mlmmjadmin. You can find it in/opt/mlmmjadmin/settings.py
, parameterapi_auth_tokens =
.netdata_db_password
: The password of SQL usernetdata
. You can find it in/root/.my.cnf-netdata
or/opt/netdata/etc/netdata/my.cnf
.first_domain_admin_password
: The password of the first mail user created during iRedMail installation.
Copy files to new locations
iRedMail Easy stores SSL cert/key files under /opt/iredmail/ssl/
, you need to
either copy or (symbol) link existing ssl cert/key to this directory with
correct files names,
/opt/iredmail/ssl/key.pem
: private key/opt/iredmail/ssl/cert.pem
: certificate/opt/iredmail/ssl/combined.pem
: full chain
Run the full deployment with iRedMail Easy platform
Please follow our tutorial Getting start with iRedMail Easy to sign up, and add your mail server info, then perform the full deployment.
Post-installation setup
iRedMail Easy will re-generate most config files, custom settings will be
loaded from files under /opt/iredmail/custom/
, so if you have any
customizations, you may need to copy your custom settings to files under
/opt/iredmail/custom/
.
Postfix config files
iRedMail Easy will rewrite config files under /etc/postfix/
, most importantly
main.cf
and master.cf
. If you have any changes in these 2 files, please
read the [Best Practice](./iredmail-easy.best.practice.html)
document to
understand how to customize them with shell script
/opt/iredmail/custom/postfix/custom.sh
.
For customizations you made in other files under /etc/postfix/
, you must
move the customizations to files under /opt/iredmail/custom/postfix/
which
have same file names.
For example, if you added some rules in /etc/postfix/helo_access.pcre
, you
should copy these rules to file /opt/iredmail/custom/postfix/helo_access.pcre
.