---
title: " Migrating to Acquia Search powered by SearchStax"
date: "2025-02-12T09:41:21+00:00"
summary: "Migrate to Acquia Search powered by SearchStax with this step-by-step checklist for Drupal configuration, indexing, and deployment."
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, visit [Acquia Search powered by SearchStax Onboarding process](/node/68491).

**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](/node/57198).

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](/node/61346)

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

2

[Install the SearchStax module](/node/61351)

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](/node/61366)

Transfer the relevant configuration and data to migrate the server from Drupal to Acquia Search powered by SearchStax.

4

[Migrate the index](/node/61371)

Create a copy of the index to migrate the index from Drupal to Acquia Search powered by SearchStax.

5

[Migrate the views](/node/61711)

Switch views to the migrated index.

6

[Configure Search term autocomplete for SearchStax](/node/97486)

Configure Search term autocomplete to enable site visitors to see suggested words or phrases as they type.

7

[Enable the SearchStax module and route searches through it](/node/61376)

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

8

[Validate the search page](/node/61381)

Verify that your search page uses the Site Search app.

9

[Execute rollback if required](/node/61441)

Do a rollback by importing the backup configuration, if required.

10

[Commit and deploy the changes](/node/61416)

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

11

[Uninstall the migration module](/node/61721)

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

12

[Remove the legacy Search module and configuration](/node/61421)

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

Next step
---------

[Prepare for the migration to Acquia Search powered by SearchStax](/node/61346)