Managing Applications
Use when:
- Listing applications you have access to
- Linking or unlinking a local repo to a Cloud application
- Creating a new Drupal or Next.js project
- Checking branch/tag deployment status
- Waiting for an async task to complete
- Exporting a full site archive
List Applications
bash
acli api:applications:list
Returns a JSON array of all applications you have access to. Each entry includes
,
,
,
,
, and
.
To display a readable table:
bash
acli api:applications:list | python3 -c "
import json, sys
apps = json.load(sys.stdin)
for a in apps:
print(f\"{a['id']:<10} {a['name']:<40} {a.get('type',''):<10} {a.get('status',''):<10}\")
"
Open Application in Browser
Opens the selected Cloud application in your default browser.
Link and Unlink a Local Repository
Associate your local checkout with a Cloud application so commands like
can detect the app automatically:
bash
cd /path/to/project
acli app:link
To remove the association:
Tail Application Logs
Stream live logs from a Cloud environment:
Prompts for the application and environment, then tails all available log streams in real time. Useful for monitoring deployments or debugging live issues.
Check Branch and Tag Deployment Status
Lists all branches and tags in the application's git repository along with which environment (if any) each is currently deployed to.
Wait for an Async Task
Some Cloud operations (database copies, environment mirrors) return a notification UUID. Wait for them to complete:
bash
acli app:task-wait <notification-uuid>
Useful in CI/CD pipelines to block until a task finishes before proceeding.
Create a New Local Project
Scaffold a new Drupal or Next.js project from an Acquia-recommended template:
bash
# Interactive — prompts for template and directory
acli app:new:local
# Non-interactive
acli app:new:local my-project --template=acquia_drupal_recommended
acli app:new:local my-project --template=acquia_drupal_cms
Available templates:
acquia_drupal_recommended
- — Acquia Drupal CMS project
Migrate from Drupal 7
Generate a new Drupal 9+ project from an existing Drupal 7 application using Acquia Migrate Accelerate:
bash
acli app:new:from:drupal7
Export a Site Archive
Export an application's code, files, and database as a single archive file:
bash
acli archive:export /path/to/destination/
Options:
bash
# Exclude public files
acli archive:export /path/to/destination/ --no-files
# Exclude database
acli archive:export /path/to/destination/ --no-database
# Use a specific source directory
acli archive:export /path/to/destination/ --dir=/path/to/drupal
Best Practices
- Link your repo — Run in every project checkout so app-aware commands work without extra flags.
- Check VCS status before deploying — Use to confirm the right branch is ready.
- Use in CI — Ensures async Cloud operations complete before the next pipeline step runs.
Related Topics
- Environment Management — List environments, deploy, create CDEs
- Pull & Push — Sync code, database, and files
- Remote Access — SSH, Drush, and log tailing
- SSH Key Management — Secure access setup