Quick links
Cloud IDE is a browser-based source code editor and a Drupal development stack running on the Cloud Platform.
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 is not 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.
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.
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:
From the command line on your local computer, run the following command to open your IDE:
acli ide:open
- In your IDE admin menu, go to Terminal > New Terminal.
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, 8.2, and 8.3 depending on your requirement.
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
max_upload_file_size
post_max_size
max_execution_time
Changes to PHP settings can display like the following example:
max_upload_file_size = 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