Associating Your Domain

Associating Your Domain with Matomo 5

Overview:

To successfully associate your domain with the Matomo 5 hosted on an AWS instance, follow the steps outlined below. This process involves editing the Apache configuration file to link your domain with the server’s IP address and enforce HTTPS redirection.

Step 1: Access Your Server

1. Log in via SSH

Use SSH to access your AWS instance:

ssh ec2-user@<your-aws-public-ip>

2. Switch to the Root User

Elevate your permissions by switching to the root user:

[ec2-user@…]$ sudo -i

Step 2: Modify the Apache Configuration File

1. Edit the Configuration File

Open the Apache configuration file:

[root …]$ nano /etc/httpd/sites-available/matomo.conf

2. Update Domain Information

Replace the placeholder yourdomain.com with your actual domain name in the configuration. Ensure that both the non-www and www versions of your domain are included. Also, modify the RewriteRule directives to enforce HTTPS redirection.

Below is the updated configuration you need to apply:

<VirtualHost *:80>
ServerName yourdomain.com
ServerAlias www.yourdomain.com
DocumentRoot /var/www/matomo
ErrorLog /var/www/log/error.log
CustomLog /var/www/log/requests.log combined

RewriteEngine on
RewriteCond %{SERVER_NAME} ^(www\.)?yourdomain\.com$ [NC]
RewriteRule ^ http://%{SERVER_NAME}%{REQUEST_URI} [END,NE,R=permanent]

….<rest of the file, leave as it is>…
</VirtualHost>

<VirtualHost *:443>
ServerName yourdomain.com
ServerAlias www.yourdomain.com
DocumentRoot /var/www/matomo
ErrorLog /var/www/log/error.log
CustomLog /var/www/log/requests.log combined

RewriteEngine on
RewriteCond %{SERVER_NAME} ^(www\.)?yourdomain\.com$ [NC]
RewriteRule ^ https://%{SERVER_NAME}%{REQUEST_URI} [END,NE,R=permanent]

….<rest of the file, leave as it is>…
</VirtualHost>

3. Save and Exit

After making the necessary changes, save the file by pressing Ctrl + O, then press Enter to confirm. Exit the editor by pressing Ctrl + X.

Step 3: Refresh Symbolic Links & Restart Apache

For the changes to take effect, recreate the symbolic links and then restart the Apache web server:

[root …]$ sudo ln -sf /etc/httpd/sites-available/matomo.conf /etc/httpd/sites-enabled/matomo.conf

[root …]$ sudo systemctl restart httpd

Additional Notes:

Ensure that you have an SSL certificate installed for HTTPS to work. You may use services such as Let’s Encrypt to obtain a free SSL certificate.
You might need to adjust firewall rules or security group settings in AWS to allow traffic on ports 80 (HTTP) and 443 (HTTPS).
Important: Request AWS to lift any email sending restrictions if you’re using the application’s email features.