Information for: DEVELOPERS   PARTNERS

Managing sites on a cluster with Drush

Although Acquia Cloud Site Factory provides a user interface to manage websites on a cluster, website maintainers who must perform highly customized website maintenance activities may instead want to leverage the power of Drush for website maintenance.

The acsf-tools repository (also included with Acquia BLT) provides a set of Drush scripts for Drupal 7 and 8 websites tuned both for multisite management and Acquia Cloud Site Factory concepts.


The acsf-tools toolkit requires Drush 8 when used with a Drupal 7 website.

Installation and configuration

To add the acsf-tools repository to your codebase, perform the steps outlined in the repository’s file. Using its procedures will allow you to download and configure scripts for use on your Acquia Cloud Site Factory websites.

For information about adding a repository as a dependency in Composer, see Using Composer with Drupal 8 sites.

Available toolkit scripts

The toolkit makes the following Drush commands available for your use:

Command Description

Performs a content staging deployment to a non-production environment.


Staging all websites at once may take a long time to complete. For more information about content staging, see Staging a Factory to a non-production environment.

acsf-tools-dump Create Drush backups for all websites in your Factory instance.

Generate Drush aliases for all websites in your Factory instance.


Improper placement of the acsf-tools-generate-aliases file can cause performance problems when executing Drush commands.

acsf-tools-get-deployed-tag Display the current version control tag deployed on an environment.
acsf-tools-info Display website-specific information, such as ID and database name, for all websites in your Factory instance.
acsf-tools-list Displays the details for all websites in your Factory instance.
acsf-tools-ml Perform a Drush command against all websites in your Factory instance.
acsf-tools-sites-backup Create a backup of any or all websites in your Factory instance.
acsf-tools-stage-domains Create non-production versions of production environment domains.

For more information about the scripts in the acsf-tools toolkit, including usage instructions, see its file.