Installing Acquia Search with Solr 7 for Drupal 7 with Search API

There are two module ecosystems that can be used for Solr with Drupal 7, Search API and Apache Solr Search. You must pick one of the two module ecosystems for your Acquia Search implementation.

For more information on each of these ecosystems, see Installing Acquia Search with Solr 7 for Drupal 7.


A single site should use only one of the preceding options. Enabling modules from both options can cause problems.

Use the following instructions to install Acquia Search with Solr 7 using the Search API module for Drupal 7.

Step 1: Prepare your new Drupal project, environment, or code base

To prepare your Drupal project, environment, or codebase, use your preferred method to copy a remote website configuration to your development environment.

Step 2: Install the Acquia Search Drupal modules

Use the following procedure to install the Acquia Search for Search API module to enable the use of Acquia Search with Solr 7:

  1. Add the following entry to the Drupal settings.php file: $conf['acquia_search_disable_version_select'] = FALSE;

  2. Download and install the Acquia Search module, and any other required modules on your website.

  3. Connect to your Acquia subscription with your Cloud Platform credentials.

  4. On the Modules admin page, enable the Acquia Search for Search API module. Be sure to approve any additional required Acquia Search-related modules.

  5. Navigate to the Search API module configuration page at Configurations > Search API.

  6. Create a new Server at Configuration with the following settings:

    • Service class as Acquia Search
    • Acquia Search Solr version as Solr 7 and above
  7. Create a new index and select the new server you just created.


    If you see the message “To protect your data, the Search API Acquia module is enforcing read-only mode on the Search API indexes, because it could not figure out what Acquia-hosted Solr index to connect to”, make sure that a Solr index has been created or an index override has been specified.

  8. Your Solr index of website content is built and maintained by periodic cron jobs. Depending on the amount of content on your website, the initial indexing process will take some time to complete.


Acquia recommends using the Solr Devel module to debug Solr indexing and queries. For the troubleshooting guide, see Using Solr Devel module to debug Solr indexing and queries.

For more information on using the Search API module, see the Search API documentation.