---
title: "What are the basic troubleshooting steps for the Acquia Search module?"
date: "2025-05-28T06:27:46+00:00"
summary: "Learn essential troubleshooting steps for Acquia Search module issues, from connection checks to hidden settings and debugging tools."
image:
type: "article"
url: "/acquia-cloud-platform/help/69381-what-are-basic-troubleshooting-steps-acquia-search-module"
id: "a7bafb4d-e108-4158-b727-3aaee4c0a840"
---

To resolve issues with the [Acquia Search](https://www.drupal.org/project/acquia_search/) module:

*   Use the [Acquia Search](https://www.drupal.org/project/acquia_search/) module messages on a Search API server or on an index page to understand why the module is failing.
*   If the module is trying to connect to `localhost` or to the IP address `127.0.0.1`, the Acquia Search module is not configured as expected or cannot detect the appropriate search index based on environment variables.
*   Check that the Drupal site can properly reach the Acquia Search API service, which provides the list of available Solr indexes for your application to your Drupal site. To check the site connection with the Acquia Search API Service, complete the following steps:
    
    1.  Navigate to the Search API Server you are trying to configure.
    2.  Click **Edit**.
    
    If properly connected, the system displays a list of available search indexes in the **SOLR INDEXES CURRENTLY AVAILABLE FOR YOUR APPLICATION** box.
    
*   If you are running the [Acquia Search](https://www.drupal.org/project/acquia_search/) module on a non-Acquia environment, you must use `$settings['acquia_search']['override_search_core']` to point the module to a search index. For more information, see [README.txt](https://git.drupalcode.org/project/acquia_search/-/blob/3.x/README.txt).
*   The [Acquia Search](https://www.drupal.org/project/acquia_search/) module has some hidden settings. For more information, see [README.txt](https://git.drupalcode.org/project/acquia_search/-/blob/3.x/README.txt).

Important

Acquia recommends using the Solr Devel module to debug Solr indexing and queries. For troubleshooting, see [Using Solr Devel module to debug Solr indexing and queries](https://acquia.my.site.com/s/article/360004454253-Using-Solr-Devel-module-to-debug-Acquia-Search-indexing-and-queries)