Common Issues

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 [email protected]>=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 [email protected]>=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 [email protected]>=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.

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.