Edit history

[B][U]Preparations[/U][/B]
Before you can start installing Mailcow, you need to do some preparations, which mainly affect the DNS settings of the domain that you want to use to receive and send e-mails. To do this, follow the steps below:

[LIST=1]
[*]The hostname of your server should be "[B]mail[/B]", so the FQDN should be "[B]mail.testdomain.com[/B]".
[*]Add an [B]A record[/B] for the subdomain "[B]mail[/B]" ([B]mail.testdomain.com[/B]) and let this point to the IP address of the mail server.
[*]Add an [B]MX record[/B] for your domain and set the value to the mail subdomain you just created ([B]mail.testdomain.com[/B]) with priority 10.
[*]Define a [B]CNAME record[/B] for the subdomains "[B]autodiscover[/B]" as well as "[B]autoconfig[/B]" and set the destination of both CNAME records to the mail subdomain as well ([B]mail.testdomain.com[/B]).
[*]Add an [B]TXT record[/B] for your domain and set the value to "[B]v=spf1 mx ~all[/B]", to allow the server specified in the MX record (the mail server where Mailcow will be installed) to send e-mails with your domain as the sender domain. The "[B]~all[/B]" means that other servers are not allowed to send e-mails from your domain, but these e-mails will still be delivered (softfail).
[*]Define a [B]PTR record[/B] (Reverse DNS) for the IP address of your server and set the value to the [B]FQDN of your server [/B]("[B]mail.testdomain.com[/B]"). You can set this PTR record directly in the web interface of any good hoster like Contabo. For some providers, you have to write an e-mail or open a support ticket.
[/LIST]
[B][U]Mailcow Installation[/U][/B]
[LIST=1]
[*]If you havn't already done so, download the program "[URL='https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html']PuTTY[/URL]".


[*]Connect to your root server or VPS/vServer via SSH using [URL='https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html']PuTTY[/URL]. To do this, open [URL='https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html']PuTTY[/URL] and enter the domain or IP address of your server in the text box named "Host Name (or IP address)". Then click the "OK" button below.


[*]Update your package lists with the command apt update.


[*]Now install any available updates of the packages already installed on your server using the command apt upgrade -y


[*]Next, install the packages needed for future installations in this tutorial by executing the following command: apt install curl nano git apt-transport-https ca-certificates gnupg2 software-properties-common -y


[*]Install Docker by completing the following steps:
[LIST=1]
[*]Use the following command to add the key needed for the Docker repository:
[B]For Debian:[/B] [COLOR=rgb(184, 49, 47)][B][U]wget -q https://download.docker.com/linux/debian/gpg -O- | apt-key add -[/U][/B][/COLOR]
[B]For Ubuntu:[/B] [COLOR=rgb(184, 49, 47)][B][U]wget -q https://download.docker.com/linux/ubuntu/gpg -O- | apt-key add -[/U][/B][/COLOR]


[*]Add the repository needed to install Docker by executing this command:
[B]For Debian:[/B] [COLOR=rgb(184, 49, 47)][B][U]add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/debian $(lsb_release -cs) stable"[/U][/B][/COLOR]
[B]For Ubuntu:[/B] [COLOR=rgb(184, 49, 47)][U][B]add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"[/B][/U][/COLOR]


[*]Now update your package lists again with the command [COLOR=rgb(184, 49, 47)][U][B]apt update[/B][/U][/COLOR]


[*]Install Docker with the following command: [COLOR=rgb(184, 49, 47)][U][B]apt install docker-ce docker-ce-cli -y[/B][/U][/COLOR]
[/LIST]
[*]Now download Docker Compose with the command [COLOR=rgb(184, 49, 47)][U][B]curl -L https://github.com/docker/compose/releases/download/$(curl -Ls https://www.servercow.de/docker-compose/latest.php)/docker-compose-$(uname -s)-$(uname -m) > /usr/local/bin/docker-compose[/B][/U][/COLOR]


[*]Then use the command [COLOR=rgb(184, 49, 47)][U][B]chmod +x /usr/local/bin/docker-compose[/B][/U][/COLOR] to assign the required execution permissions to Docker Compose.


[*]Run the command [COLOR=rgb(184, 49, 47)][B][U]cd /opt[/U][/B][/COLOR] to change to the directory "/opt"


[*]Download Mailcow/the master branch of the corresponding repository with the following command: [COLOR=rgb(184, 49, 47)][B][U]git clone https://github.com/mailcow/mailcow-dockerized[/U][/B][/COLOR]


[*]Execute the command [COLOR=rgb(184, 49, 47)][B][U]cd mailcow-dockerized[/U][/B][/COLOR] to go to the Mailcow directory.


[*]Now the configuration file for Mailcow needs to be generated. Use the command [COLOR=rgb(184, 49, 47)][B][U]./generate_config.sh[/U][/B][/COLOR]  You will then be asked for an FQDN. Enter the FQDN of your server ("[B]mail.testdomain.com[/B]") and press enter. You can skip the question about the time zone by pressing enter, because the correct time zone should already be set by default.


[*]The configuration file is now generated. You can optionally customize it with the command [COLOR=rgb(184, 49, 47)][U][B]nano mailcow.conf[/B][/U][/COLOR] if you, for example, already have a web server installed and you therefore have to use different ports ("[B]HTTP_PORT[/B]" and "[B]HTTPS_PORT[/B]") for the Mailcow web server. You can also change the value of the parameter "[B]SKIP_LETS_ENCRYPT[/B]" to "[B]y[/B]" if you don't want an SSL certificate to be automatically requested/issued from Let's Encrypt. If you made changes to this configuration, save them by pressing [B]CTRL + X, then hit the "Y" key and press enter[/B].


[*]Download the images needed for Mailcow with the following command: [COLOR=rgb(184, 49, 47)][U][B]docker-compose pull[/B][/U][/COLOR]


[*]Now start the Mailcow container by executing the command [COLOR=rgb(184, 49, 47)][U][B]docker-compose up -d[/B][/U][/COLOR]


[*]Mailcow automatically requests a [B]Let's Encrypt SSL certificate[/B]for the domain you specified as the hostname ("acme-mailcow" container), unless this feature has been explicitly disabled within the configuration file. Thus, you can visit the Mailcow web interface via HTTPS. To automatically redirect HTTP requests to HTTPS, perform the following steps:
[LIST=1]
[*]Create an Nginx configuration file using the command [COLOR=rgb(184, 49, 47)][U][B]nano /opt/mailcow-dockerized/data/conf/nginx/redirect.conf[/B][/U][/COLOR]
[*]Add the following content to this configuration file:

[I]server {  root /web;
listen 80 default_server;
listen [::]:80 default_server;
include /etc/nginx/conf.d/server_name.active;
if ( $request_uri ~* "%0A|%0D" ) { return 403; }
location ^~ /.well-known/acme-challenge/ {
allow all;
default_type "text/plain";
}
location / {
return 301 https://$host$uri$is_args$args;
}
}[/I] 


[*]Save the changes to this configuration file by pressing [B]CTRL + X, then hit the "Y" key followed by enter[/B].
[*]Now restart Nginx. To do this, use the command [COLOR=rgb(184, 49, 47)][B][U]docker-compose restart nginx-mailcow[/U][/B][/COLOR]  All HTTP requests will now be automatically redirected to HTTPS.
[/LIST]
[/LIST]
[B][U]Mailcow Configuration[/U][/B]
[LIST=1]
[*]Open the Mailcow web interface under the domain of your server in your web browser via HTTPS. If you have changed the web server port in the configuration file, you must now of course specify this port (e.g. "[B]https://mail.testdomain.com:4433[/B]").
[*]Log in with the username "[B]admin[/B]" and the default password "[B]moohoo[/B]".
[*]Click on "[B]Edit[/B]" right next to the "[B]admin[/B]" user under "[B]Edit administrator details[/B]".
[*]Change the password of the administrator user. You can also change the username if you want. After you've done this, click on the "[B]Save changes[/B]" button.
[*]Click on "[B]Configuration[/B]" in the top menu and then click on "[B]Mail Setup[/B]" to switch to the mail configuration.
[*]The tab "[B]Domains[/B]" is already selected. Add your domain by clicking on the "[B]Add domain[/B]" button. In the dialog that appears, enter the domain in the "[B]Domain[/B]" text box and a description in the "[B]Description[/B]" text box. You can change the rest of the settings (e.g. the maximum amount of possible mailboxes or the mailbox quota), but the default values should be fine in most cases. Next, click on the button called "[B]Add domain and restart SOGo[/B]".
[*]Switch to the "[B]Mailboxes[/B]" tab and add a new mailbox by clicking on "[B]Add mailbox[/B]". You have to enter the following information:
[LIST]
[*][B]Username[/B]: Left part of the e-mail address (before the "@")
[*][B]Domain[/B]: Domain to which the mailbox belongs
[*][B]Full name[/B]: First and last name of the mailbox user
[*][B]Quota (MiB)[/B]: Quota of this mailbox (default 3072 MiB)
[*][B]Password[/B]: Password of the mailbox user
[/LIST]
[*]Then click on the "[B]Add[/B]" button to create the mailbox.
[*]Mailcow is now basically set up. However, it's recommended to perform further configurations such as the [B]DKIM configuration[/B]. The DKIM configuration is explained in the next step of this tutorial. For further information, the [URL='https://mailcow.github.io/mailcow-dockerized-docs/']Mailcow documentation[/URL] is very helpful.
[/LIST]
[B][U]DKIM Configuration[/U][/B]
[LIST=1]
[*]Log in to the Mailcow web interface and click on "[B]Configuration[/B]" at the top menu. Then click on "[B]Configuration & Details[/B]".
[*]Click on the "[B]Configuration[/B]" tab and then on "[B]ARC/DKIM keys[/B]"
[*]Enter your domain in the "[B]Domain/s[/B]" text box under "[B]Add ARC/DKIM key[/B]".
[*]You can leave the DKIM selector (text box "[B]Selector[/B]") at "[B]dkim[/B]" or you can change it if you want.
[*]Then select "[B]2048 bits[/B]" as the "[B]DKIM key length (bits)[/B]" in the dropdown menu.
[*]Click on the "[B]Add[/B]" button to generate a DKIM key for your domain.
[*]Now copy the contents of the text box above (public key matching the domain, starting with "v=DKIM1;k=rsa;t=s;s=email;p=") under "[B]ARC/DKIM keys[/B]".
[*]Finally, add a TXT record for "[B]dkim._domainkey.testdomain.com[/B]" (matching the DKIM selector) in your domain's DNS settings and set the previously copied content from the text box as the value of this TXT record.
[/LIST]
[B][U]Using the Webmail Client "SOGo"[/U][/B]
Of course, you can use mail clients like Thunderbird or Outlook, but Mailcow also offers it's own webmail client. Using this webmail client, you can also read your e-mails directly in the browser:

[LIST=1]
[*]In the top menu of the Mailcow web interface, click on "[B]Apps[/B]" and then click on "[B]Webmail[/B]" or open the webmail client directly by appending "[B]/SOGo[/B]" to the domain of your server.
[*]Now log in to the webmail client. Enter the complete e-mail address of the mailbox as user name and enter the corresponding password.
[*]You should already see an e-mail in the inbox, because a personal calendar was automatically created for you. Now you can use the SOGo webmail client.
[/LIST]
[B][U]Setting up a Mail Client (e.g. Thunderbird)[/U][/B]
Of course, you can also add your mailboxes to traditional mail clients such as Thunderbird, Outlook or Apple Mail. Usually, you only need to specify the [B]username[/B] (e-mail address of the mailbox) and the [B]password[/B]. The server settings should be determined automatically. If this doesn't work, use the following server settings:
Top Bottom
Search

Search

Edit history
