Magento 2.3.1 Blank page after installing sample data

Magento 2.3.1 Blank page after installing sample data

September 12, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento 2.3.1 Blank page after installing sample data

Resolving Magento 2.3.1 Blank Page After Installing Sample Data

If you’re facing a blank page after installing sample data on your Magento 2.3.1 installation, don’t worry—you’re not alone. This is a common issue that many developers encounter during the setup process. In this guide, we’ll walk through the steps to troubleshoot and resolve this problem.

Understanding the Error

The error message you’re seeing suggests that there’s an issue with the permissions of the generated directory. Magento requires write access to this directory for proper functioning. Let’s address this first:

# Change ownership to webserver user
sudo chown -R www-data:www-data generated/

# Ensure the 'generated' directory has write permissions
sudo chmod -R 775 generated/

After running these commands, clear your cache and sessions:

php bin/magento cache:clean
rm -rf var/cache/*
rm -rf var/session/*

Compiling Magento

If you’re still encountering the blank page issue, let’s try a full compilation of Magento. This process generates necessary code for optimal performance.

First, enable maintenance mode:

php bin/magento maintenance:enable

Then, run the following commands to compile and deploy static content:

php bin/magento setup:upgrade --keep-generated
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f

Finally, reindex your data and disable maintenance mode:

php bin/magento indexer:reindex
php bin/magento maintenance:disable

Checking the Database

Ensure that your database is connected correctly and all tables are present. You can check the status of your database using phpMyAdmin or MySQL commands.

If any tables are missing, you might need to re-install the Magento sample data:

php bin/magento setup:install --base-url=http://example.com/ --db-host=localhost --db-name=magentodb --db-user=magentouser --db-password=magentopassword --admin-firstname=John --admin-lastname=Doe --admin-email=john.doe@example.com --admin-username=administrator --admin-password=password123456

Layout Issues

While unlikely in this scenario, a layout issue could potentially cause a blank page. If you suspect a layout problem, check your XML layouts and themes for any conflicting or incorrectly configured elements.

Remember to always backup your files before making any changes to avoid data loss.

Conclusion

Troubleshooting the Magento 2.3.1 blank page issue after installing sample data involves ensuring proper permissions, running necessary commands, and checking your database status. By following these steps, you should be able to resolve the problem and see your Magento store up and running with sample data.

For more detailed guides on Magento setup and troubleshooting, feel free to explore our comprehensive resources at Laravel Company.

If you’re still facing difficulties or need further assistance, don’t hesitate to reach out to our support team. We’re always here to help!

Magento 2 Cache Indexing Performance

Our network