Here are some tips for troubleshooting issues you might run into while using Acquia Dev Desktop. In addition to the tips on this page, be sure to review the following documentation pages:
Examining log files
Acquia Dev Desktop creates two log files in its top-level folder:
installer.log– Records everything done during the most recent installation. This log is useful for diagnosing issues during the Acquia Dev Desktop install process
piscript.log– Records actions performed with Acquia Dev Desktop. This log is useful for diagnosing runtime issues.
Both of these logs are packaged and sent to Acquia when you use the Help > Report an issue feature.
Enabling verbose debug logging
You can enable verbose logging and progress monitoring text, which can be useful for debugging issues. Open Acquia Dev Desktop > Preferences > General, and select Verbose logging. If, before you report an issue to Acquia, you enable verbose logging and then reproduce the issue you encountered, the logs you send will have more information, which makes it easier to diagnose the issue. You can then disable verbose logging to reduce disk space usage and improve Acquia Dev Desktop performance.
Collisions in settings.php
When you create a local website or sync a website from Acquia Cloud, Acquia Dev Desktop modifies the website's
settings.php file. It adds a block enclosed in comments labeled
DDSETTINGS at the end of the
settings.php file. Some Drupal modules may possibly modify the
settings.php file in a way that conflicts with the Acquia Dev Desktop settings. If you run into errors, read the documentation for the Drupal module to see if it has special requirements for
settings.php, and consider whether the module settings can be moved after the
DDSETTINGS block in the
Problems syncing sites with Acquia Cloud
You won't be able to sync websites with Acquia Cloud unless your Acquia Cloud user profile has the correct permissions. For more information, see Acquia Cloud credentials and permissions.
If Drush isn't working on your Acquia Cloud website, you won't be able to sync the website using Acquia Dev Desktop. To test Drush on your Acquia Cloud website:
- Connect to your Acquia Cloud website with SSH.
- Run a Drush command, such as
If that doesn't work, either contact Acquia Support (if you are an Acquia subscriber with support), or use the Feedback button in the Acquia Cloud UI to report your issue.
SSH key error
If, when you synchronize a website between Acquia Dev Desktop and Acquia Cloud, you experience an SSH key error, you may be able to resolve it by doing the following:
- In Acquia Dev Desktop, click Acquia Dev Desktop > Preferences.
- On the Settings > General tab, click Remove local websites cloned from Acquia Cloud, and then click OK.
- Click the + button and select Add Acquia Cloud websites.
Workaround: Use the Acquia Cloud import procedure
If you're unable to sync your local website to Acquia Cloud, as a workaround you can try to use the import procedure described in Acquia Cloud: Importing manually and Importing your codebase using Git.
Problems with installation
If you have problems installing Acquia Dev Desktop, see Reporting issues, feature requests, and bugs: Problems with installation.
Timeout during stack start
You could get a timeout error (for example, "Process 'MySQL database server' failed to start") while starting Acquia Dev Desktop if you have unusually large or many databases. If this happens, you can try increasing the
startTimeout setting in the Acquia Dev Desktop
dynamic.xml configuration file. When you modify the
startTimeout setting, make sure that Acquia Dev Desktop is not running; otherwise, edits to
dynamic.xml will not persist. The
dynamic.xml configuration file is located:
- On macOS, in
/Applications/DevDesktop/common/cfgbox/Acquia Dev Desktop.app/Contents/MacOS/dynamic.xml
- On Windows, in
C:\Program Files (x86)\Dev Desktop\common\cfgbox\AcquiaDevDesktop\dynamic.xml
The default value of the
startTimeout setting is 30 seconds. You may want to increase this to 240 or 300 (4 or 5 minutes).
If after checking out these troubleshooting tips, you still have problems, see Reporting issues, feature requests, and bugs.