Known issues¶

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

The Git history panel can lock the IDE for a few seconds¶

A known Theia issue is that the Git history panel does not respect the maximum count (100) of Git commits to display. Depending upon the size of your Git history, this can lead to running into performance issues with the IDE being locked for a few seconds and up to a minute while all commits and file changes are being fetched.

Workaround:

1. Right-click the History icon and click Close to close the panel.
2. Reload the IDE entirely in the browser.

Acquia recommends that you use the git log command in the IDE Terminal window until this issue is fixed.

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 fails to load if you add a custom SSH key with a passphrase¶

Acquia automatically adds and manages SSH keys in Cloud IDE so that you can use the Theia Git plugin automatically.

If you create a custom SSH key with a passphrase, Theia cannot load the Git plugin because it does not know the passphrase. As a result, your IDE fails to load entirely with the Error occurred while trying to proxy error.

Acquia recommends that you use the SSH public key that Acquia automatically creates in your IDE. It is with the form id_rsa_acquia_ide_<UUID>.pub so that you can easily determine the IDE the key belongs to at any point in time.

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/*

BLT does not recognize the Cloud IDE environment as a local environment¶

By design, BLT does not recognize Cloud IDE environments as local environments.

Workaround:

Use the BLT plugin that allows a Cloud IDE environment to be treated like a local environment. For more information on this plugin, see Using Cloud IDE with BLT.