Skip to content

Acquia Integration

DDEV provides integration with the Acquia Cloud Platform, which allows Acquia users to quickly download and provision a project from Acquia in a local DDEV-managed environment.

DDEV’s Acquia integration pulls database and files from an existing project into your local system so you can develop locally.

Acquia Quickstart

  1. Get your Acquia API token from Account SettingsAPI Tokens.
  2. Make sure you’ve added your SSH key to your Acquia account in Account SettingsSSH Keys.
  3. Run ddev auth ssh. (Typically once per DDEV session, not every pull.)
  4. In ~/.ddev/global_config.yaml, add or update the web_environment section with the API keys:
- ACQUIA_API_KEY=xxxxxxxx
  1. Copy .ddev/providers/acquia.yaml.example to .ddev/providers/acquia.yaml.
  2. Update the project_id and database corresponding to the environment you want to work with.
  3. If you have acli installed, you can run: acli remote:aliases:list.
  4. Or, on the Acquia Cloud Platform navigate to the Environments page, click on the header, and look for the SSH URL line. For example, uses project ID
  5. Your project must include Drush. Run ddev composer require drush/drush if it isn’t there already.
  6. Run ddev restart.
  7. Use ddev pull acquia to pull the project database and files.
  8. Optionally use ddev push acquia to push local files and database to Acquia. Be aware that ddev push is a command that can potentially damage your production site, so we don’t recommend using it.


ddev pull acquia will connect to the Acquia Cloud Platform to download database and files. To skip downloading and importing either file or database assets, use the --skip-files and --skip-db flags.

Last update: December 28, 2022