iredmail-doc/en_US/howto/subdomain.web.apps.md

Run web applications under subdomain with Nginx

[TOC]

Introduction

By default, Roundcube, SOGo, Netdata and iRedAdmin are located at /mail, /SOGo, /netdata and /iredadmin. If you have SOGo but no Roundcube, /mail will be redirected to /SOGo too.

For example, if your server hostname is mail.example.com, and you correctly added an A type DNS record pointed to this iRedMail server, you should be able to visit them with URLs below:

• Roundcube webmail: https://mail.example.com/mail
• SOGo Groupware: https://mail.example.com/SOGo
• Netdata monitor: https://mail.example.com/netdata
• iRedAdmin or iRedAdmin-Pro: https://mail.example.com/iredadmin

The URIs are defined in the catch-all Nginx web host config file /etc/nginx/sites-available/00-default-ssl.conf, here's its full content:

#
# Note: This file must be loaded before other virtual host config files,
#
# HTTPS
server {
    listen 443 ssl http2;
    listen [::]:443 ssl http2;
    server_name _;      # <- Name `_` will catch all web domain names,
                        # <- this is why this file must be loaded before other
                        # <- web host config files.

    root /var/www/html;
    index index.php index.html;

    include /etc/nginx/templates/misc.tmpl;         # <- Misc
    include /etc/nginx/templates/ssl.tmpl;          # <- SSL related configurations.
    include /etc/nginx/templates/iredadmin.tmpl;    # <- iRedAdmin
    include /etc/nginx/templates/roundcube.tmpl;    # <- Roundcube webmail
    include /etc/nginx/templates/sogo.tmpl;         # <- SOGo Groupware
    include /etc/nginx/templates/netdata.tmpl;      # <- Netdata monitor
    include /etc/nginx/templates/php-catchall.tmpl; # <- php support
    include /etc/nginx/templates/stub_status.tmpl;  # <- Nginx status monitoring
}

As you can see, it loads multiple configuration snippets, and they define the URIs you can access to visit the web applications.

iRedMail also generates configuration snippet files to run them under subdomain:

• /etc/nginx/templates/iredadmin-subdomain.tmpl
• /etc/nginx/templates/netdata-subdomain.tmpl
• /etc/nginx/templates/roundcube-subdomain.tmpl
• /etc/nginx/templates/sogo-subdomain.tmpl

Run web applications under subdomain

To run Roundcube, SOGo and/or iRedAdmin under subdomain, you can simply create a new web host config file, and load the *-subdomain.tmpl file.

Let's say you want to run Roundcube under subdomain webmail.example.com.

• Update DNS record to point domain name webmail.example.com to your iRedMail server.
• Create new web host config file /etc/nginx/sites-available/webmail.example.com.conf with content below:

server {
    listen 443 ssl http2;
    listen [::]:443 ssl http2;
    server_name webmail.example.com;

    include /etc/nginx/templates/misc.tmpl;
    include /etc/nginx/templates/ssl.tmpl;
    include /etc/nginx/templates/roundcube.tmpl;
}

• Create symbol link to /etc/nginx/sites-enabled/ with shell command below:

ln -sf /etc/nginx/sites-available/webmail.example.com.conf /etc/nginx/sites-enabled/webmail.example.com.conf

• [OPTIONAL] If you want to remove acess from https://mail.example.com/mail/ (mail.exmaple.com is your server hostname), you can simply comment out below line in /etc/nginx/sites-available/00-default-ssl.conf:

include /etc/nginx/templates/roundcube.tmpl;

• Restart or reload Nginx service:

service nginx restart

Important notes

• File /etc/nginx/templates/ssl.tmpl loads self-signed ssl cert by default, we strongly recommend to request free SSL cert by following our tutorial: Request a free cert from Let's Encrypt.

  Note: You can request one cert with multiple domain names.

• You can also create your own Nginx configuration snipppet file with different SSL cert/key files too.