Troubleshooting your installation

If your site does not install correctly, there are some configuration tips that you might want to check.

Tip

Note that if you are using the Dev Desktop, you need not do any of this.

Memory settings

Sometimes, memory settings may need to be adjusted to get your site running correctly. Here are some suggestions on things to adjust.

If you are getting out of memory errors during installation, you can try increasing the memory available to Drupal.

When you imported the Drupal 8 site, the Dev Desktop will have created a site folder, which contains a settings file specifically. The site-specific settings file is called settings.php and can be found in the default folder.

Note that the default folder is also linked to the drupal-8.dd symlink.

Locate and edit the file:

/sites/default/settings.php

Add a new line:

ini_set('memory_limit', '128M');

This increases the memory allocated to PHP when running your site. 128M should be sufficient, but if you still have problems, try increasing this. Note that by default, the file should have been set to read only on your system and therefore you may need to take some action before you can save your changes.

PHP timeouts

If you have a slower computer, sometimes the PHP timeout settings needs to be increased to allow more time for the installation steps to be completed.

In the same settings file as before:

docroot/sites/default/settings.php

Add a new line:

ini_set('max_execution_time', '240');

The 240 here refers to the number of seconds and this should be sufficient, but if you still have problems, try increasing this again.