Installing Acquia Purge

Caching content on your website is an important step towards improving your website’s performance. Identifying and purging content changes translates to improved timeliness of content for site visitors while maximizing the sites’ response times and ability to scale. The Acquia Purge module was designed from the ground up to automate the management of updating content in Cloud Platform, and therefore ideally a Varnish-cached, website.

With this module, you can purge all load balancers on Cloud Platform.


Acquia recommends that you test your website with Acquia Purge on a clone or copy of your Drupal website in a test server environment before you upgrade your production server.

Installing Acquia Purge

  1. Add Purge and Acquia Purge modules to the codebase of your application running the current Drupal version. You must always use the latest available release. Enable the following modules:

    • purge

    • purge_ui

    • purge_drush

    • purge_queuer_coretags

    • purge_processor_cron

    • purge_processor_lateruntime

    • acquia_purge

  2. To increase your TTL or max-age to 1 month:

    1. Navigate to /admin/config/development/performance.

    2. In the Page cache maximum age drop-down menu, select 1 month in the Caching section.

    Alternatively, you can use Drush as follows:

    $ drush @site.env config-set -y system.performance 2764800
  3. Navigate to /admin/config/development/performance/purge, and click the Add purger option in the Cache invalidation section.


    If you do not see the Add purger option, rebuild caches.

    The system displays a pop-up window to confirm the purger that you want to add. By default, Cloud Platform is selected.

    1. Click Add. After the purger is added, a green tick appears in the TAG column.

    Alternatively, you can use Drush to add the purger:

    $ drush p-purger-add --if-not-exists acquia_purge
    The purger is created.
  4. To confirm that your setup is complete, access /admin/config/development/performance/purge, or run drush purge-diagnostics. If all checks return OK, you’re all set.

    drush @site.env p-diagnostics

Next step

Although Acquia Purge is in use on your site, it’s not yet configured for optimal results. For information about how you can optimize Acquia Purge for your site, see:

Module questions and comments

If you have any questions or comments about the module for its maintainer, or you’ve found a bug or some other issue, you can file an issue in the issue queue.