Tutorial—Set up multiple websites or stores with nginx

This configuration expands upon Magento Nginx Configuration. To create one virtual host:

1. Open a text editor and add the following contents to a new file named /etc/nginx/sites-available/magento:

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   map $http_host $MAGE_RUN_CODE {
       default '';
       french.mysite.mg french;
       german.mysite.mg german;
   }
   
   server {
       listen 80;
       server_name mysite.mg french.mysite.mg german.mysite.mg;
       set $MAGE_ROOT /var/www/html/magento2;
       set $MAGE_MODE developer;
       set $MAGE_RUN_TYPE website; #or set $MAGE_RUN_TYPE store;
       include /var/www/html/magento2/nginx.conf;
   }
   

2. Save your changes to the files and exit the text editor.

3. Verify the server configuration:

   1
   nginx -t
   

4. If successful, the following message displays:

   1
   nginx: configuration file /etc/nginx/nginx.conf test is successful
   

   If errors display, check the syntax of your virtual host configuration files.

5. Create symbolic link in the /etc/nginx/sites-enabled directory:

   1
   2
   cd /etc/nginx/sites-enabled
   ln -s /etc/nginx/sites-available/magento magento
   

For more detail about the map directive, see nginx documentation on the map directive.

To create multiple virtual hosts:

1. Open a text editor and add the following contents to a new file named /etc/nginx/sites-available/french.mysite.mg:

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   map $http_host $MAGE_RUN_CODE {
       french.mysite.mg french;
   }
   
   server {
       listen 80;
       server_name french.mysite.mg;
       set $MAGE_ROOT /var/www/html/magento2;
       set $MAGE_MODE developer;
       set $MAGE_RUN_TYPE website; #or set $MAGE_RUN_TYPE store;
       include /var/www/html/magento2/nginx.conf;
   }
   

2. Create another file named german.mysite.mg in the same directory with the following contents:

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   map $http_host $MAGE_RUN_CODE {
       german.mysite.mg german;
   }
   
   server {
       listen 80;
       server_name german.mysite.mg;
       set $MAGE_ROOT /var/www/html/magento2;
       set $MAGE_MODE developer;
       set $MAGE_RUN_TYPE website; #or set $MAGE_RUN_TYPE store;
       include /var/www/html/magento2/nginx.conf;
   }
   

3. Save your changes to the files and exit the text editor.

4. Verify the server configuration:

   1
   nginx -t
   

5. If successful, the following message displays:

   1
   nginx: configuration file /etc/nginx/nginx.conf test is successful
   

   If errors display, check the syntax of your virtual host configuration files.

6. Create symbolic links in the /etc/nginx/sites-enabled directory:

   1
   2
   3
   cd /etc/nginx/sites-enabled
   ln -s /etc/nginx/sites-available/french.mysite.mg french.mysite.mg
   ln -s /etc/nginx/sites-available/german.mysite.mg german.mysite.mg
   

For more details about the map directive, see nginx documentation on the map directive.

To modify the nginx.conf.sample file:

1. Open a text editor and review the nginx.conf.sample file ,<magento2_installation_directory>/nginx.conf.sample. Look for the following section:

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   # PHP entry point for main application
   location ~ (index|get|static|report|404|503|health_check)\.php$ {
       try_files $uri =404;
       fastcgi_pass   fastcgi_backend;
       fastcgi_buffers 1024 4k;
   
       fastcgi_param  PHP_FLAG  "session.auto_start=off \n suhosin.session.cryptua=off";
       fastcgi_param  PHP_VALUE "memory_limit=756M \n max_execution_time=18000";
       fastcgi_read_timeout 600s;
       fastcgi_connect_timeout 600s;
   
       fastcgi_index  index.php;
       fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
       include        fastcgi_params;
   }
   

2. Update the nginx.conf.sample file with the following two lines before the include statement:

   1
   2
        fastcgi_param MAGE_RUN_TYPE $MAGE_RUN_TYPE;
        fastcgi_param MAGE_RUN_CODE $MAGE_RUN_CODE;
   

An example updated PHP entry point for the main application looks like:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
# PHP entry point for main application

location ~ (index|get|static|report|404|503|health_check)\.php$ {
    try_files $uri =404;
    fastcgi_pass   fastcgi_backend;
    fastcgi_buffers 1024 4k;

    fastcgi_param  PHP_FLAG  "session.auto_start=off \n suhosin.session.cryptua=off";
    fastcgi_param  PHP_VALUE "memory_limit=756M \n max_execution_time=18000";
    fastcgi_read_timeout 600s;
    fastcgi_connect_timeout 600s;

    fastcgi_index  index.php;
    fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
    # START - Multisite customization
    fastcgi_param MAGE_RUN_TYPE $MAGE_RUN_TYPE;
    fastcgi_param MAGE_RUN_CODE $MAGE_RUN_CODE;
    # END - Multisite customization
    include        fastcgi_params;
}