---
title: " Migrating to Acquia Search powered by SearchStax"
date: "2025-02-12T09:41:21+00:00"
summary: "Migrate to Acquia Search powered by SearchStax for faster, more relevant search results. Step-by-step guide for Drupal users."
image:
type: "page"
url: "/acquia-cloud-platform/migrating-acquia-search-powered-searchstax"
id: "bd12019c-4f02-4858-ba9b-4d4ca0d3bbd5"
---

Acquia Search powered by SearchStax provides quick and relevant search results.

This page provides information about how to get started with Acquia Search powered by SearchStax by using your existing Drupal search configurations and index data.

Key concepts for migration
--------------------------

Before you migrate from Acquia Search (Solr) to SearchStax Site Search, you must understand the shift from infrastructure-managed indexing to an application-centric model. Use the following terminology mapping to align the Drupal configuration:

*   **SearchStax App**: In the Site Search ecosystem, an App serves as the logical equivalent of a Solr Core or Collection. It acts as the primary container for index data, relevance rules, and analytics.
*   **Search API Server**: In Drupal, a Server represents the remote connection to the SearchStax App API. While Acquia Search typically uses internal authentication, SearchStax uses specific App Endpoints and API Keys to facilitate the connection.
*   **Search API Index**: An Index object defines the specific subset of Drupal entities, such as Nodes, Media, and Users, to synchronize with SearchStax App.
*   **Multisite indexing**: If a single SearchStax App is shared across multiple Drupal environments or sites, you must implement Unique Index IDs or Site Prefixes. This implementation ensures that data remains logically partitioned in the App, prevents document collision, and ensures that search results scope correctly to the requesting site.

For details and multisite guidance, refer to [Acquia Search powered by SearchStax Onboarding process](https://docs.acquia.com/acquia-cloud-platform/acquia-search-powered-searchstax-onboarding-process).

Important

Before you start the migration process, set up a SearchStax account with your Acquia ID. Registration with any other ID returns an authentication error. If you do not have an account or require assistance to access the account, contact the account team or [Acquia Support](/service-offerings/contacting-acquia-support "Contacting Acquia Support").

Migration checklist
-------------------

Use the following checklist to migrate to Acquia Search powered by SearchStax:

Important

These steps require changes to your Drupal configuration and the modules installed on your Drupal applications. Therefore, you must deploy them to all environments to complete the migration from Acquia Search to Acquia Search powered by SearchStax.

**S.No.**

**Task**

**Description**

1

[Prepare for the migration to Acquia Search powered by SearchStax](/acquia-cloud-platform/preparing-migration-acquia-search-powered-searchstax "Preparing for the migration to Acquia Search powered by SearchStax")

Complete the steps to prepare for the migration to Acquia Search powered by SearchStax.

2

[Install the SearchStax module](/acquia-cloud-platform/installing-searchstax-module "Installing the SearchStax module")

*   Install the SearchStax module in your development environment using Composer and Drush commands.
*   Enable the SearchStax module, and replace your old Acquia Search server setup with the new SearchStax apps configuration.

3

[Migrate the server from Drupal to Acquia Search powered by SearchStax](/acquia-cloud-platform/migrating-server-drupal-acquia-search-powered-searchstax "Migrating the server from Drupal to Acquia Search powered by SearchStax")

Transfer the relevant configuration and data to migrate the server.

4

[Migrate the index from Drupal to Acquia Search powered by SearchStax](/acquia-cloud-platform/migrating-index-drupal-acquia-search-powered-searchstax "Migrating the index from Drupal to Acquia Search powered by SearchStax")

Create a copy of the index to migrate it.

5

[Migrate the views from Drupal to Acquia Search powered by SearchStax](/acquia-cloud-platform/migrating-views-drupal-acquia-search-powered-searchstax "Migrating the views from Drupal to Acquia Search powered by SearchStax")

Switch views to the migrated index.

6

[Enable the SearchStax module and route searches through it](/acquia-cloud-platform/enabling-searchstax-module-and-routing-searches-through-it "Enabling the SearchStax module and routing searches through it")

Configure the SearchStax Studio module to redirect searches on your Drupal application to Site Search.

7

[Validate the search page](/acquia-cloud-platform/validating-search-page "Validating the search page")

Test the functionality and verify that your search page uses the Site Search app.

8

[Execute rollback if required](/acquia-cloud-platform/executing-rollback-if-required "Executing rollback if required")

To perform a rollback, if required, import the backup configuration.

9

[Commit and deploy the changes](/acquia-cloud-platform/committing-and-deploying-changes "Committing and deploying changes")

Commit the updates, perform testing with CI/CD workflows, and deploy the changes to production.

10

[Uninstall the migration module](/acquia-cloud-platform/uninstalling-migration-module "Uninstalling the migration module")

Migrate your existing Drupal index to SearchStax and then uninstall the migration module.

11

[Remove the legacy Search module and configuration](/acquia-cloud-platform/removing-legacy-search-module-and-configuration "Removing the legacy Search module and configuration")

Uninstall the Search module, remove configurations, and commit and deploy changes.

Next step
---------

[Prepare for the migration to Acquia Search powered by SearchStax](/acquia-cloud-platform/preparing-migration-acquia-search-powered-searchstax "Preparing for the migration to Acquia Search powered by SearchStax")