Magento 2 in subfolder Nginx

Magento 2 in subfolder Nginx

August 23, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento 2 in subfolder Nginx

Configuring Magento 2 in a Subfolder Using Nginx

The Problem: Running Magento 2 in a Subdirectory

If you’re trying to run Magento 2 within a subdirectory of your existing website on an Ubuntu server with Nginx, you might be facing challenges setting up the configuration correctly. This is especially true if you already have other projects running in the /var/www directory and want to maintain that setup.

In this scenario, you’ve attempted to configure Magento 2 following their official Nginx guide (https://github.com/magento/magento2/wiki/Nginx-Configuration-Settings-and-Environment-Variables), but are encountering an error:

location /demos/demo-magento2/ {
  set $MAGE_ROOT /mnt/storage/demo-magento2/;
  set $MAGE_MODE developers;
  include /mnt/storage/demo-magento2/nginx.conf.sample;
}

The error message indicates that the setup location is outside of the defined demos/demo-magento2/ path, which suggests an issue with the included configuration file (nginx.conf.sample).

Understanding the Nginx Configuration for Magento 2

Before we proceed, let’s understand why this error occurs. The included nginx.conf.sample file provided by Magento is designed to handle a wide range of configurations, including subdirectories. However, it assumes that the main root directory is at the top level (/var/www/html).

When you include this file in your existing server block that has other projects in /var/www, it conflicts with the assumed root path, leading to the error.

A Step-by-Step Solution

To resolve this issue without disrupting your existing projects’ configurations, follow these steps:

  1. Create a New Nginx Server Block

Instead of modifying your existing server block that handles other projects, create a new one specifically for Magento 2. This will allow you to keep the configurations separate and avoid conflicts.

In your main Nginx configuration file (usually located at /etc/nginx/sites-available/default), add a new server block below the existing ones:

# New server block for Magento 2
server {
    # Set the domain name
    server_name demo.website.com;

    # Set the document root to your Magento installation directory
    root /mnt/storage/demo-magento2/;
}

Replace demo.website.com with your actual domain or subdomain, and ensure the path matches your Magento 2 directory.

  1. Configure the Location Blocks

Inside this new server block, add the necessary location blocks for both the main application and the setup process:

# Main application location
location / {
    # Other configurations...
}

# Setup process location
location ~ ^/(setup|install)$ {
    fastcgi_pass   unix:/var/run/php5-fpm.sock;
    include        fastcgi_params;

    fastcgi_index  index.php;
    fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
}

The location ~ ^/(setup|install)$ block ensures that the setup process is handled correctly.

  1. Include the Magento Nginx Configuration

In your main server block, include the Magento Nginx configuration file:

include /mnt/storage/demo-magento2/nginx.conf.sample;

Ensure the path to nginx.conf.sample matches your actual installation directory.

Testing and Validating

After making these changes, save the file and reload the Nginx configuration:

sudo service nginx restart

Or, if you’re using Nginx’s built-in commands:

service nginx reload

Now, when you access demo.website.com in your browser, it should load your Magento 2 installation without any conflicts with your existing projects.

Conclusion

Configuring Magento 2 to run in a subdirectory requires careful management of the Nginx server blocks and location paths. By creating a separate server block for Magento 2 and including their official configuration file, you can ensure your setup works seamlessly without disturbing other projects on your server.

Remember that this solution assumes you have access to modify the Nginx configuration files and understand basic Nginx syntax. If you’re still encountering issues, feel free to reach out to the Magento community or consult with a professional developer for further assistance.

For more detailed guides on Magento 2 development and deployment, consider checking out resources at Laravel Company.

Magento 2 Configuration Errors

Our network