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¶

Get your Acquia API token from Account Settings → API Tokens.
Make sure you’ve added your SSH key to your Acquia account in Account Settings → SSH Keys.
Run ddev auth ssh. (Typically once per DDEV session, not every pull.)
In $HOME/.ddev/global_config.yaml (see global configuration directory) add or update the web_environment section with the API keys:
```
web_environment:
    - ACQUIA_API_KEY=xxxxxxxx
    - ACQUIA_API_SECRET=xxxxx
```
You can also do this with:
```
ddev config global --web-environment-add="ACQUIA_API_KEY=xxxxxxxx,ACQUIA_API_SECRET=xxxxx"
```
What if I have more than one API key?

To use multiple API keys for different projects, add them to your per-project configuration using the .ddev/config.local.yaml file instead. This file is gitignored by default.
```
web_environment:
    - ACQUIA_API_KEY=xxxxxxxx
    - ACQUIA_API_SECRET=xxxxx
```

In the project .ddev/config.yaml add the ACQUIA_ENVIRONMENT_ID environment variable:

web_environment:
    - ACQUIA_ENVIRONMENT_ID=yoursite.dev

You can also do this with:

ddev config --web-environment-add="ACQUIA_ENVIRONMENT_ID=yoursite.dev"

Run ddev restart.
Use ddev pull acquia to pull the project database and files.
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.

Usage¶

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.