Information for: DEVELOPERS   PARTNERS   SUPPORT

Cloud IDE

Cloud IDE is a browser-based source code editor and a Drupal development stack running on the Cloud Platform.

QUICK LINKS: Getting started  | FAQ | User interface  | Container  | Preferences  | Terminal  | Command palette | E-learning material

Requirements

Cloud IDE requires the latest version of one of the following browsers:

  • Chrome

  • Edge

  • Firefox

  • Safari

Eligibility

Cloud IDE is available as an add-on feature for Cloud Platform subscriptions by contacting your Account Manager. If you don’t have an Account Manager, contact Acquia Sales.

Cloud IDE isn’t available for subscribers with specific regulatory or compliance requirements.

Getting started

Create a new Cloud IDE. You can then clone your Cloud Platform application into your IDE.

Managing existing IDEs

The following commands can help you manage your existing IDEs:

  • acli ide:list: Display a list of existing IDEs.

  • acli ide:open: Open an existing IDE in your web browser.

  • acli ide:delete: Delete an existing IDE.

Important

Deleting an IDE deletes all information, files, and databases from that environment. Acquia cannot recover this data.

Understanding the user interface

Cloud IDE displays the files and directories from your Drupal codebase in an Explorer pane on the left. Double-clicking on any file will open the source code editor on the right, providing access to viewing or modifying files.

For more information about the user interface, see Using Cloud IDE. For information about configuring preferences in the user interface, see Settings and preferences.

The Cloud IDE user interface contains an explorer pane, a source code editor, and a preview pane

Understanding IDE hibernation

Cloud IDE will automatically hibernate after two hours of inactivity. Once you access the IDE or Web preview again, Cloud IDE will automatically get out of hibernation and will be usable again after about 30 seconds.

Cloud IDE hibernation shows a loading icon when it leaves hibernation

IDE container resources

For a list of the tools, developer resources, and services available in the Cloud IDE container, see Resources in Cloud IDE.

Using the Cloud IDE terminal

Cloud IDE provides you with a terminal with access to the Bash shell. To learn more about using and configuring the terminal, see Using the terminal in Cloud IDE.

Note

Cloud IDE users don’t have access to sudo or root user.

Working with PHP

The default PHP version for Cloud IDE is PHP 8.1. With Cloud IDE, you can configure the PHP version and Xdebug.

Configuring the PHP version

To configure the PHP version:

  1. From the command line on your local computer, run the following command to open your IDE:

    acli ide:open

  2. In your IDE admin menu, go to Terminal > New Terminal.

  3. Run the following command at the IDE terminal:

    acli ide:php-version 8.2

    Note

    In this command, version 8.2 is used as an example.

    You can configure the PHP versions 7.4, 8.1, and 8.2 as desired.

You can use the following command to check the current PHP version:

ide:~/project$ php -v
PHP 8.2.7 (cli) (built: Jul  6 2023 13:01:51) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.2.7, Copyright (c) Zend Technologies
with Zend OPcache v8.2.7, Copyright (c), by Zend Technologies

Configuring PHP settings

To override the default PHP settings for Cloud IDE, you must change the following file:

/home/ide/configs/php/custom.ini

The PHP settings you can change include, but aren’t limited to the following:

  • memory_limit

  • upload_max_filesize

  • post_max_size

  • max_execution_time

Changes to PHP settings can display like the following example:

upload_max_filesize = 100M
post_max_size = 50M
max_execution_time = 240
memory_limit = 1G

To restart PHP-FPM to apply the changes you’ve made, run the following command:

acli ide:service-restart php

53 State Street, 10th Floor
Boston, MA 02109
United States
Phone: 888-922-7842