Common Issues

Required parameter 'theme_dir' was not passed

The issue appears when you have an incorrect theme path in the theme configuration in the database.

To fix the issue follow the steps below:

1. Connect to your database using the database client. (like Beekeeper Studio)

   You can get host, port and credentials after running the status command.

2. Open core_config_data table and find a row with design/theme/theme_id path value.

3. Open theme table and find a row with theme_id value corresponding to value from the previous step.

4. Make sure that theme_path value is the same as the one declared in your theme's registration.php file. (for ScandiPWA it will be likely scandipwa/scandipwa)

SQLSTATE[HY000] [2002] No such file or directory

An error message should look like this:

Response: SQLSTATE[HY000] [2002] No such file or directory

In InstallCommand.php line 274:
                               
Parameter validation failed  
                               

setup:install ...

This issue happens when env.php file is missing.

Run start command the second time.

SQLSTATE[HY000] [2006] MySQL server has gone away

Should not appear on magento-scripts@>=1.3.0.

Response: SQLSTATE[HY000] [2006] MySQL server has gone away

In InstallCommand.php line 274:
                               
Parameter validation failed


setup:install ...

This issue might appear at the first start of the project.

Run start command the second time.

The default website isn't defined. Set the website and try again.

Should not appear on magento-scripts@>=1.4.0.

This issue might appear if you, for some reason, have no Magento database installed in MySQL.

Delete app/etc/env.php file, after that run start command. This will force CMA to reinstall Magento but you will lose some configuration, for example, a persisted query that is required for the ScandiPWA theme.

Connection to Redis localhost:port failed after 1 failures. Connection refused.

Should not appear on magento-scripts@>=1.3.1.

This issue might appear if your port configuration has changed but Magento still uses old configuration.

There are 2 options on how to solve such a problem:

• Get current port configuration from docker ps or status command and edit app/etc/env.php file and run the start command.

Recommended, as it is the safest option.

• Delete app/etc/env.php file and run the start command.

Not recommended, because you will lose all the configuration from that file.

Redis is not configured for persistent queries.

Should not appear on magento-scripts@>=1.6.0

This issue might appear if you have a theme installed but persisted queries are not set up for some reason.

Run link command to re-link the theme and setup persisted queries.

There are no commands defined in the "config" namespace.

This issue might appear if you have previously installed Magento with CMA but now lost all the data in MySQL for some reason.

Delete app/etc/env.php and run the start command again.