This tutorial will show you how to install the groupware iRedMail on a fresh installation of FreeBSD 10.<\/p>\n

You should use a server with at least\u00a0one gigabyte<\/strong>\u00a0of memory, preferably even two. While the software doesn’t use many resources when idling, it peaks very fast when under load. For example, during virus scans.<\/p>\n

Important<\/strong>: Please do not try to install iRedMail on a system that’s already in production. It’s designed to be installed on a\u00a0fresh<\/strong>\u00a0installation and will override other MTAs when it finds them. Please be cautious and always have backups at hand.<\/p>\n

For the course of this tutorial, we will assume that you are working as the administrative user. If you want to use\u00a0sudo<\/code>\u00a0instead, then you will have to append it where necessary.<\/p>\n

First, make sure that a fully qualified domain name is set by opening\u00a0\/etc\/rc.conf<\/code>\u00a0with your favorite text editor and replacing the value there with a FQDN:<\/p>\n

hostname=\"mail.example.com\"\r\n<\/code><\/pre>\n
Next, make sure that FQDN is the first value listed in\u00a0\/etc\/hosts<\/code>:<\/p>\n
127.0.0.1   mail.example.com mail localhost localhost.localdomain\r\n<\/code><\/pre>\n
Verify that everything worked by issuing\u00a0hostname -f<\/code>. The output should be:<\/p>\n
mail.example.com\r\n<\/code><\/pre>\n
The only dependency of iRedMail is\u00a0bash-static<\/code>\u00a0(and\u00a0wget<\/code>\u00a0to fetch it) which can be found in the official pkg-repositories:<\/p>\n
pkg\r\npkg update -f\r\npkg install bash-static\r\n<\/code><\/pre>\n
Since the installation script builds everything from FreeBSD’s ports tree, you need to fetch it:<\/p>\n
portsnap fetch extract\r\n<\/code><\/pre>\n
Due to some complications with the Apache versioning from FreeBSD 10 upwards, you need to add the following to\u00a0\/etc\/make.conf<\/code>\u00a0to ensure that the installation script works:<\/p>\n
DEFAULT_VERSIONS=apache=2.2\r\n<\/code><\/pre>\n
Download and unpack the latest version from the official homepage:<\/p>\n
wget https:\/\/bitbucket.org\/zhb\/iredmail\/downloads\/iRedMail-0.8.7.tar.bz2\r\ntar -xf iRedMail-0.8.7.tar.bz2\r\n<\/code><\/pre>\n
Change the permissions of the script, and run the installer:<\/p>\n
cd iRedMail-0.8.7\/\r\nchmod 700 iRedMail.sh\r\n.\/iRedMail.sh\r\n<\/code><\/pre>\n
The installation script will ask you some questions:<\/p>\n
\n
Location for the mailboxes,\u00a0\/var\/vmail<\/code>\u00a0is the default and perfectly fine.<\/li>\n
Backend used to store the accounts, there is no default. For a small number of users,\u00a0MySQL<\/code>\u00a0is just fitting – if you want to integrate into, for example, an ActiveDirectory user base then you should choose\u00a0OpenLDAP<\/code>.<\/li>\n
A password for the administrative MySQL user – be careful\u00a0not<\/strong>\u00a0to use special characters as this will cause problems.<\/li>\n
First virtual domain name – example.com for this tutorial.<\/li>\n
A password for the administrative mailuser – you should also avoid special characters.<\/li>\n
Optional components – you should at least choose iRedAdmin, phpMyAdmin and Roundcubemail for this question.<\/li>\n<\/ul>\n
The installer will now prompt you about a file with sensitive information in it,\u00a0\/root\/iRedMail-0.8.7\/config<\/code>, make sure to properly set the file permissions when the installation is finished:<\/p>\n
chmod 600 \/root\/iRedMail-0.8.7\/config\r\n<\/code><\/pre>\n
The installation script installs\u00a0a lot<\/strong>\u00a0of packages, and it may take some time to complete since everything is building from source.<\/p>\n
Now you’ll be prompted with all the necessary information to use iRedMail – after a reboot:<\/p>\n
reboot\r\n<\/code><\/pre>\n
(Don’t worry, the prompted information can be found in\u00a0\/root\/iRedMail-0.8.7\/iRedMail.tip<\/code>\u00a0after the reboot.)<\/p>\n
The webmail interface can now be accessed with your web browser at:<\/p>\n
https:\/\/mail.example.com\/mail\r\n<\/code><\/pre>\n
However, since iRedMail uses a certificate that’s not issued by a legitimate certificate authority (CA), you will most likely get a security warning from your browser. If you would like to remove the security warning, then you will need to obtain a certificate from a trusted CA. Installing a different certificate requires both the certificate and the private key. Once uploaded to your server, these files can be copied to the proper location with the following commands:<\/p>\n
cp \/path\/to\/your\/cert \/etc\/ssl\/certs\/iRedMail_CA.pem\r\ncp \/path\/to\/your\/key \/etc\/ssl\/private\/iRedMail.key\r\n<\/code><\/pre>\n
Then, restart everything that uses the cert\/key:<\/p>\n
service postfix restart\r\nservice dovecot restart\r\nservice apache2 restart\r\n<\/code><\/pre>\n
And now you have a all-in-one mail solution. Happy mailing!<\/p>\n
Other Versions<\/h4>\n
Debian<\/a><\/strong><\/span><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"open","ping_status":"closed","template":"","format":"standard","manualknowledgebasecat":[230],"manual_kb_tag":[420],"_links":{"self":[{"href":"https:\/\/support.aklwebhost.com\/wp-json\/wp\/v2\/manual_kb\/2752"}],"collection":[{"href":"https:\/\/support.aklwebhost.com\/wp-json\/wp\/v2\/manual_kb"}],"about":[{"href":"https:\/\/support.aklwebhost.com\/wp-json\/wp\/v2\/types\/manual_kb"}],"author":[{"embeddable":true,"href":"https:\/\/support.aklwebhost.com\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/support.aklwebhost.com\/wp-json\/wp\/v2\/comments?post=2752"}],"version-history":[{"count":1,"href":"https:\/\/support.aklwebhost.com\/wp-json\/wp\/v2\/manual_kb\/2752\/revisions"}],"predecessor-version":[{"id":2753,"href":"https:\/\/support.aklwebhost.com\/wp-json\/wp\/v2\/manual_kb\/2752\/revisions\/2753"}],"wp:attachment":[{"href":"https:\/\/support.aklwebhost.com\/wp-json\/wp\/v2\/media?parent=2752"}],"wp:term":[{"taxonomy":"manualknowledgebasecat","embeddable":true,"href":"https:\/\/support.aklwebhost.com\/wp-json\/wp\/v2\/manualknowledgebasecat?post=2752"},{"taxonomy":"manual_kb_tag","embeddable":true,"href":"https:\/\/support.aklwebhost.com\/wp-json\/wp\/v2\/manual_kb_tag?post=2752"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}