---
title: "Removing the legacy Search module and configuration"
date: "2025-02-12T17:50:59+00:00"
summary: "Learn how to safely remove the legacy Acquia Search module after migrating to Acquia Search powered by SearchStax. Follow our step-by-step guide to uninstall, remove configuration, and ensure smooth functionality post-removal."
image:
type: "page"
url: "/acquia-cloud-platform/removing-legacy-search-module-and-configuration"
id: "6a49dd44-d6a9-47b0-b700-e79708a35e15"
---

Prerequisites to ensure before you uninstall and remove the [Acquia Search](https://www.drupal.org/project/acquia_search) module:

*   Confirm that the migration is successful.
*   Confirm that indexing is complete.
*   Verify that Acquia Search powered by SearchStax functions as expected in your production environment.

Warning

Drupal cannot uninstall a module after you remove it from the codebase. You must uninstall the module and remove any of its associated configuration from the database before using Composer to remove the module.

To remove the module:

1.  Remove any remaining legacy Acquia Search configuration, such as Search server, Search index, and Search views.
2.  Disable the [Acquia Search](https://www.drupal.org/project/acquia_search) module.
3.  Disable the [Acquia Connector](https://www.drupal.org/project/acquia_connector) module.
4.  Conduct comprehensive testing of the changes to ensure the capabilities of Acquia Search powered by SearchStax continue to function as expected.
5.  Export configuration or record configuration changes.
6.  [Commit and deploy the changes](/acquia-cloud-platform/committing-and-deploying-changes "Committing and deploying changes").
7.  Remove the [Acquia Search](https://www.drupal.org/project/acquia_search) module from Composer after you uninstall the module.
    
    Important
    
    If your site uses the [Acquia Drupal Starter Kit Toolbar](https://www.drupal.org/project/acquia_cms_toolbar), do not remove the [Acquia Search](https://www.drupal.org/project/acquia_search) module from your codebase because it is a dependency for the [Acquia Drupal Starter Kit Common](https://www.drupal.org/project/acquia_cms_common) module, which is further a dependency for the [Acquia Drupal Starter Kit Toolbar](https://www.drupal.org/project/acquia_cms_toolbar). Retaining the disabled [Acquia Search](https://www.drupal.org/project/acquia_search) module in the codebase does not affect site functionality.
    
8.  [Commit and deploy the changes](/acquia-cloud-platform/committing-and-deploying-changes "Committing and deploying changes").
9.  Conduct user testing and ensure that features function as expected.
10.  Delete your Legacy Acquia Search index from Acquia Cloud in the Cloud Platform user interface. For instructions, visit [Delete a Solr index](https://docs.acquia.com/acquia-cloud-platform/managing-search-indexes#section-delete-a-solr-index).
11.  Protect your non-production environments from excessive bot traffic by installing the Shield Module. For details, visit [Password Protecting Non-Prod Env](/acquia-cloud-platform/add-ons/shield/help/90431-password-protecting-non-prod-env "Password Protecting Non-Prod Env").