This page helps troubleshoot common issues that you may encounter when using Autopilot.
If you have already attempted to troubleshoot an error, or if you want to confirm that the error is consistent, try running Autopilot on the site again:
Review and acknowledge any errors to allow Autopilot to queue updates.
If there are errors that require attention, in the Needs Review section of the Autopilot screen, click Review Test Results next to the site you want to review, and Approve or Discard a test, or Accept All Changes before you run Autopilot again.
Click Sites > Actions > Manage Autopilot Settings.
Navigate to the Autopilot Configuration screen > click Refresh Updates to force Autopilot to check for new components (like plugins, modules, or themes).
Click Status in Autopilot's side bar > click Queue Updates under Available Updates to run Autopilot manually.
You must manually start an update, or Autopilot will automatically schedule one in accordance with your site's update cadence. To start an update manually:
Click Actions in the site's row on the Autopilot screen > click Start Applying Updates.
If a test that was waiting was approved after changing the Dev environment, Autopilot will periodically check to see if Dev has changed since Autopilot last ran.
Autopilot is blocked due to uncommitted SFTP code changes.
Autopilot will fail if there are uncommitted SFTP code changes in the Dev environment.
If commits are pushed to Dev after the Autopilot Multidev is created, you run the risk of having a merge conflict when Autopilot is pushed back to Dev.
If Autopilot attempted to deploy, then either: tests have already passed; or the less likely event that a test that was waiting, was approved after changing the Dev environment.
If you experience this error, it will likely be at the end of the flow, at which point you should re-run Autopilot with the latest changes to ensure all is covered in testing. Autopilot will also log an error, which can be found in the activity feed.
Autopilot ran into an unexpected error. Contact Support for assistance.
We could not run Autopilot because the site is running an unsupported Drush version.
An error occurred because your site is currently running an unsupported version of Drush.
If your Drupal site is not managed with Composer, Autopilot only works on sites that are running Drush 8. Composer-managed sites may use any compatible Drush version and will not display the Drush version error.
Autopilot only supports Integrated Composer; Build Tools sites cannot be updated.
To resolve this issue, switch to Drush 8 in the
pantheon.yml file or use Integrated Composer.
We could not apply the updates because a plugin, theme, or module was not found while attempting the update.
- WordPress: This error message is displayed if a WordPress plugin or theme is not found after updates were attempted.
- Drupal: This error message is displayed if a Drupal module or theme update could not be applied.
To determine which plugin is causing the issue:
Check the uncommitted changes for Autopilot Multidev. It is likely a plugin has been deleted and another plugin has been added.
Compare the list of plugins between the Autopilot and Dev environments and determine if there are any discrepancies. Ensure no entries are missing. If there is variance between the lists, such as a plugin that has been omitted or not updated on one of the lists, the plugin will be disabled on the Autopilot branch.
If you need assistance, contact Support.
Remove the plugin, theme, or module from the site if it is not being used. You can also revert the plugin, theme, or module to the original name.
Alternatively, you can add the plugin, theme, or module to the Excluded Updates list in Autopilot settings.
There was an unexpected error preventing Autopilot from taking screenshots of your website.
Could not apply the extension updates.
Applying extension updates failed.
Applying updates with Drush or WP-CLI failed. This could be because of a read/write error, PHP fatal error thrown by the CMS, or another site-level error.
Ensure Drush or the WP-CLI works as expected on the Dev and Multidev environments.
Apply the plugin or theme updates either in the UI or with Drush or WP-CLI using Terminus. Resolve any issues or errors that arise. After conflicts are resolved, the updates should be committed to the
If possible, manually edit or update the plugins required to resolve the update failure and allow Autopilot to run its subsequent round of updates.
We could not apply the upstream updates.
Applying upstream updates failed and changes cannot be automatically merged by Git.
This error message most likely results from a merge conflict when applying upstream updates to the site. For sites that use Composer, this could be caused by a failed Composer build.
Resolve conflicts to apply updates. Use the auto-resolve option in the Dashboard to resolve conflicts in favor of the upstream Git repository. Alternatively, you can manually pull changes using Git, resolve the conflicts, and then push the updates to your Pantheon site. For more information, refer to the documentation on Applying Upstream Updates.
If the error is displayed due to a failed Composer build, use
git diff to view changes, and examine the error in the log. Composer build logs are only available after the action completes or fails. For more information, refer to the documentation on Troubleshooting Code Syncs and Upstream Updates and Adding Dependencies to Your Upstream.
This error can also display if some of the updates failed testing. This results in partial updates, in which the updates that passed testing are applied, while the updates that failed testing are not applied. Refer to the Failing Tests section for more information on how to resolve failed tests.
We could not complete the visual regression test due to a redirect error on one or more pages.
The visual regression test (VRT) could not be completed due to a redirect error on one or more pages.
Autopilot fails when a VRT page redirects more than 8 times or is stuck in an infinite loop.
To resolve this issue, remove the page from VRT settings or fix the redirect in the Dev environment for the page.
We could not run Autopilot because no pages are defined for visual regression testing.
Could not deploy the updates to the Test or Live environment due to an unexpected error.
Autopilot failed to deploy to Test or Live; however, deploying to Dev from Multidev was successful. The most common reason for this is running clear cache or update db using Drush or the WP-CLI failed after the code was deployed. Ensure that clearing the cache using Drush or the WP-CLI works on the target environment.
If the Drush or WP-CLI steps failed during diagnosis, resolve any errors thrown by the CMS.
Run the deploy to Test or Live manually. Autopilot will also attempt to deploy again when the updates are tested, but immediately running updates again will likely result in the response that Autopilot has no new updates to apply, because the Dev environment already has changes.
If these steps fail, contact Support.
We ran into an unexpected issue with Autopilot because the site could not be loaded in the Dev environment.
Could not create or reset the Autopilot Multidev due to an unexpected error.
This can result from Drush or WP-CLI failing after
db pull. This might be Autopilot specific, due to a site-level CMS issue, or could also be due to a platform-wide event.
Check that CLI cache clear steps work in the Dev environment. See if creating other Multidevs works correctly, delete the Autopilot environment and branch. Deleting the branch is important because the branch remains in Git if only the Multidev is deleted. If these actions works correctly, try running Autopilot again.
The error could be caused by a Composer build failure if you are utilizing Integrated Composer,
Check the build log in the Site dashboard. Review the most recent commit to see if an error was posted.
You can also use Composer 2 to test locally and identify issues by running
composer install or
We could not merge the updates to the Dev environment due to an unexpected issue.
Updates could not be merged to the Dev environment.
The most common reason for failure is due to a merge conflict. Changes were deployed in the Dev environment after Autopilot ran that resulted in a merge conflict. This error could also be because of a site-level PHP issue with
update.php failing following a merge.
If failure is because of a merge conflict, run Autopilot again with latest changes.
If the issue is because of a PHP or CMS issue, resolve any issues causing
update.php steps to fail, and manually merge again, or re-run Autopilot.
We could not clone the environments due to an unexpected error.
The most common reason for clone content to fail is that drush/wr-cli clear cache failed at the end of a workflow.
Ensure the commands work. You will not be able to see if the workflow failed, but CSEs will be able to confirm if there was an issue with Drush or WP-CLI by replicating the step with Terminus.
Use the following steps:
wp cache flush
We could not run Autopilot because there is unsaved work in the development environment. Commit or discard the change, and retry Autopilot.
We could not run Autopilot because a CMS was not detected. Install Drupal or WordPress on this site, and retry Autopilot.
We could not run Autopilot because the site is frozen due to inactivity.
We could not run Autopilot because the site is running an unsupported framework.
Site is running a framework that is not Drupal, Drupal 8, or WordPress. Currently, WordPess Multisite (
wordpress_network) is not supported.
Contact support for assistance if running a framework that is not Drupal, Drupal 8, or WordPress. Any other framework, including WordPress Multisite Network is not supported.
We ran into an issue with Autopilot because Drush or WP-CLI did not work as expected.
There is an issue with Autopilot because Drush or WP-CLI did not work as expected in the Dev or Autopilot environment.
terminus remote:drush $SITE.dev -- pml or
terminus remote:wp $SITE.dev -- plugin list and check for an unexpected output or errors. Alternatively, you can use the command
$SITE.autopilot for the Autopilot environment.
After diagnosing the problem, resolve the issue that is causing the error on the Dev or Autopilot environment, then retry Autopilot. For additional help contact Support[/support] for assistance.
We could not execute some Quicksilver scripts on this site.
We ran into an issue with Autopilot because the database could not be updated.
An issue with Autopilot occurred because the WordPress Dev, Test, or Live database could not be updated.
Update the database on the target environment, and then retry Autopilot. You will be prompted to run the update on the admin dashboard of the site, or you can run
wp core update-db in the CLI. Contact Support[/link] for assistance if the issue persists.