This page describes any known issues with Cloud IDE.

If you encounter any difficulties with Cloud IDE, contact Acquia Support for assistance.

Collation errors after you upgrade Cloud IDE to MySQL 8.0

After you upgrade Cloud IDE to MySQL 8.0, you may encounter collation errors when your Cloud Classic and Site Factory infrastructure run on MySQL 5.7. This causes database import and synchronization commands like drush sql-dump to fail. This occurs because of an incompatibility between the default collation settings in MySQL versions MySQL 8.0 and MySQL 5.7.

Workaround: To resolve this issue, you can run the following command manually in the terminal:

acli pull:db

Playwright browser support

By default, Playwright installs several browsers. WebKit, one of the default browsers, is not supported by Cloud IDE containers. However, Cloud IDE containers provide the system dependencies necessary to run Firefox and Google Chrome.

Workaround: You can install a supported browser such as Google Chrome or Firefox by running one of the following commands:

npx playwright install firefox
npx playwright install chrome

Error when trying to open a Drupal application

You might get a 400 bad request error when clicking Manage Drupal Application > Open Drupal Application in the Cloud IDE menu bar. This occurs as you indirectly add a subdomain to your redirects. 

Workaround: 

1. Comment out the following lines within the . file:

This page describes any known issues with Cloud IDE.

If you encounter any difficulties with Cloud IDE, contact Acquia Support for assistance.

Collation errors after you upgrade Cloud IDE to MySQL 8.0

After you upgrade Cloud IDE to MySQL 8.0, you may encounter collation errors when your Cloud Classic and Site Factory infrastructure run on MySQL 5.7. This causes database import and synchronization commands like drush sql-dump to fail. This occurs because of an incompatibility between the default collation settings in MySQL versions MySQL 8.0 and MySQL 5.7.

Workaround: To resolve this issue, you can run the following command manually in the terminal:

acli pull:db

Playwright browser support

By default, Playwright installs several browsers. WebKit, one of the default browsers, is not supported by Cloud IDE containers. However, Cloud IDE containers provide the system dependencies necessary to run Firefox and Google Chrome.

Workaround: You can install a supported browser such as Google Chrome or Firefox by running one of the following commands:

npx playwright install firefox
npx playwright install chrome

Error when trying to open a Drupal application

You might get a 400 bad request error when clicking Manage Drupal Application > Open Drupal Application in the Cloud IDE menu bar. This occurs as you indirectly add a subdomain to your redirects. 

Workaround: 

1. Comment out the following lines within the .htaccess file:

   copy

   RewriteCond %{HTTP_HOST} !^www\. [NC] 
   RewriteRule ^(.*)$ https://www.%{HTTP_HOST}%{REQUEST_URI} [L,R=301]

2. In the Cloud IDE menu bar, click Manage Drupal Application > Open Drupal Application and verify that everything works as expected. If you continue facing issues, clear your browser cache.

Only one IDE can be used at a time

If you’re working with multiple IDEs simultaneously, you might receive the following error message when performing an action that requires invoking a Cloud Platform API endpoint. For example, when using Acquia CLI.

Your Cloud Platform API credentials are invalid.

It happens because at the moment only one IDE at a time can be authenticated against the Cloud Platform API. To work around this issue, ensure that only one IDE is opened in a browser tab at any given point in time.

The automated Cloud Platform API authentication might fail

Cloud IDE automatically connects to the Cloud Platform API. However, sometimes the connection might fail. As a workaround, you can generate a Cloud Platform API token and manually authenticate using Acquia CLI with the following command:

acli auth:login

Cloud IDE is incompatible with database prefixes

In Cloud IDE, Acquia preconfigures your database connection so that you can run your application without requiring manual configuration of the Drupal database array. However, if you use database prefixes, Acquia cannot detect this custom setting and you must configure the Drupal database array manually in settings.php.

Downloading a large database through the visual database editor can fail

The visual database editor offers the option to generate and locally download a MySQL backup of your tables. Due to the very nature of PHP processes and fixed timeouts across the stack (Apache and nginx), it is normal that databases larger than a few hundred megabytes will fail to download.

The best practice to download a database backup from Cloud Platform is to leverage Acquia CLI, by using the pull:db --no-import command. Alternatively, to download the IDE database, use Drush or a raw MySQL command instead.

Pulling an application times out when the Shield tunnel is down

In Cloud IDE, pulling an application times out with the following error when the Shield tunnel is down.

ssh: connect to host myapp01live.ssh.enterprise-g1.acquia-sites.com port 22: Connection timed out

To prevent this issue, use a network monitoring tool to generate keepalive pings. For more information, see resolving Shield issues.

Sending emails from Cloud IDE doesn’t work

Sending emails from Cloud IDE is not currently supported. As a workaround, you can use an external SMTP relay.

Cloud IDE reserved paths cannot be used as Drupal custom paths

For monitoring and authentication purposes, Cloud IDE has defined a number of reserved paths. This means those paths cannot be used in your Drupal application and will fail to load entirely for the expected node or endpoint.

Here is the list of reserved paths:

/health
/check
/oauth
/forbidden

The workaround is to use different paths in your Drupal application.

Dark Reader browser extension runs into API limits

The Dark Reader browser extension (Chrome / Firefox) increases the number of HTTP requests per page load as it analyzes images and sends them to a third party to see if the colors should be inverted. This results in too many API requests to the IDE proxy and display the following error:

{
    "error": "rate_limit_exceeded",
    "message": "You have reached the maximum number of requests to the API. Please try again later."
}

Vimium browser extension might break the IDE functionality

The Vimium browser extension (Chrome / Firefox) provides keyboard shortcuts for navigation and control in the browser. It might break the IDE functionality, such as the Vim editor in the terminal. Acquia recommends disabling the Vimium browser extension by creating a rule.

To create a rule, go to Vimium Options, and add the following URL in the “Patterns” field. Click Add Rule, and then click Save Changes.

https?://*.ide.ahdev.cloud/*

Federated Authentication requires a workaround

If you use Federated Authentication, you must use a workaround before configuring a newly-created IDE. When you try to access a resource that requires additional authentication through Acquia CLI, you get the following error:

This resource requires additional authentication on these two issues:

Twig syntax suggestions are broken

When you remove the Drupal SDC Helper plugin, the Twig syntax helper in Cloud IDE breaks. The upcoming release provides a replacement.

Workaround: You can install their preferred Twig-friendly extensions until a new plugin is added.