404 NOT FOUND error Magento installation process

404 NOT FOUND error Magento installation process

August 24, 2026 · Illustrated author avatarBy Stefan Bogdanescu
404 NOT FOUND error Magento installation process

Solving the “404 NOT FOUND” Error During Magento Installation on Ubuntu

Introduction

Installing Magento on an Ubuntu server is a common task for e-commerce developers. However, even with correct PHP and database configurations, you might encounter a frustrating “404 NOT FOUND” error when attempting to access your newly installed Magento store.

In this post, we’ll troubleshoot the common causes of this issue and guide you through the necessary steps to resolve it.

Common Reasons for the 404 Error

Incorrect Document Root Configuration

The most frequent cause of a 404 error in Apache configurations is an incorrectly specified DocumentRoot directive. Ensure that the directory path points exactly to your Magento installation folder.

DocumentRoot /var/www/magento2/public_html

Missing .htaccess File

Magento relies heavily on the .htaccess file for rewriting URLs and enabling SSL support. If this file is missing or corrupted, you’ll encounter a 404 error.

To verify its existence:

  1. Navigate to your Magento installation folder: cd /var/www/magento2/public_html
  2. Look for the .htaccess file using the command: ls -la

If it’s missing, recreate it by copying the default file from your Magento root directory:

cp /var/www/magento2/.htaccess /var/www/magento2/public_html/

Permissions Issues

Incorrect file permissions can prevent Apache from serving your Magento pages. Ensure that your files have the correct ownership and permissions.

Use this command to set the proper permissions recursively:

chmod -R 755 var/ pub/static/ generated/
chown -R apache:apache .

Resolving the 404 Error

Step 1: Verify Apache Configuration

Ensure that your Apache configuration file for Magento is correctly set up. Check if the ServerName, DocumentRoot, and <Directory> sections match your installation details.

Your sites-available/magento2.conf file should look something like this:

<VirtualHost *:80>
    ServerAdmin webmaster@localhost
    DocumentRoot /var/www/magento2/public_html
    ServerName localhost

    <Directory "/var/www/magento2/public_html">
        AllowOverrideAll
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

Step 2: Enable the Site and Reload Apache

Enable your Magento site by creating a symbolic link to the sites-enabled directory:

sudo ln -s /etc/apache2/sites-available/magento2.conf /etc/apache2/sites-enabled/

Then, reload or restart Apache to apply the changes:

sudo systemctl reload apache2

Step 3: Set Permissions

If you haven’t already, ensure that your Magento files have the correct permissions. Use the following commands:

chown -R www-data:www-data /var/www/magento2/
find /var/www/magento2/ -type d -exec chmod u+x {} \;

Conclusion

Resolving a “404 NOT FOUND” error during Magento installation involves carefully validating your Apache configuration, ensuring the presence of the .htaccess file, and setting the correct permissions for your files.

If you’re still encountering issues after following these steps, consider checking for other common pitfalls like incorrect base_url settings in your Magento configuration or missing environment variables. For a comprehensive guide on Magento installation best practices, I recommend visiting Laravel Company’s official blog.

Remember that patience and systematic troubleshooting are key when dealing with server-based software like Magento. Don’t hesitate to reach out to the Magento community or professional support if you need further assistance.

Happy coding!

Magento 2 Database Security Configuration

Our network