User Documentation

Drupal Frequently Asked Questions (FAQ)

Sign up for Upsun

Get your free trial by clicking the link below.

Get your Upsun free trial

How can I import configuration on production? Anchor to this heading

If you don’t want to do so manually, include the following lines in your deploy hook in

drush -y updatedb
drush -y config-import

That automatically runs update.php and imports configuration on every new deploy.

The above configuration is included by default if you used the Drupal example repository or created a project through the Console.

I’m getting a PDO Exception ‘MySQL server has gone away’ Anchor to this heading

Normally, this means there is a problem with the MySQL server container and you may need to increase the storage available to MySQL to resolve the issue. Ballooning MySQL storage can be caused by a number of items:

  1. A large number of watchdog entries being captured. Examine the watchdog logs and resolve the errors reported.
  2. Cron should run at regular intervals to ensure cache tables get cleared out.
  3. You are using database caching. That isn’t recommended, primarily because it can balloon the size of the database. Redis caching is recommended for all Drupal sites.

Why do I get “MySQL can’t connect to the database server”? Anchor to this heading

If you are having a problem connecting to the database server, you need force a redeployment of the database container. To do so, you can edit the service definition to add or remove a small amount of storage and then push.

For Drupal sites, the name of the session cookie is based on a hash of the domain name. This means that it’s actually consistent for a specific website and can safely be used as a fixed value.

Why do I see “File not found”? Anchor to this heading

If you see a bare “File not found” error when accessing your Drupal site with a browser, you’ve pushed your code as a vanilla project but no index.php has been found.

Make sure your repository contains an index.php file in the web location root.

Is this page helpful?