Documentation > Drupal

Drupal Configuration Steps

Drupal
Looking for a simpler approach? The new Opensolr Search module for Drupal 10/11 replaces Search API Solr entirely — AI-powered hybrid search with zero indexing load on Drupal. Get it on Drupal.org

Drupal Configuration Steps (Legacy / Manual Method)

If the Search API Opensolr module's AutoConfigure feature does not work for your Drupal version, or if you prefer manual setup, follow these steps to connect Drupal to Opensolr using standard Basic Auth.

DRUPAL MANUAL SETUP FLOW1. Basic Authselect in Drupal2. Credentialssimple password3. Set Path/solr + core name4. Uploadconfig files5. Reloadthen indexDone!searchingUse this method when AutoConfigure is not available for your Drupal version.Avoid special characters in credentials — they cause URL encoding issues.

Step-by-Step Setup

Step 1: Select Basic Auth in Drupal

In your Drupal admin, go to the Solr Server settings and select Basic Auth as the authentication method (instead of the Opensolr-specific connector).

Step 2: Set Simple Credentials

In your Opensolr Index Control Panel, go to the Security tab and set a simple username and password. For testing, use something straightforward like:

Setting Value
Username myuser
Password mypass123

Avoid special characters — they can cause URL encoding issues in some Drupal versions.

Step 3: Enter Credentials in Drupal

In your Drupal Solr server settings, add the credentials you just set:

  • HTTP username: your Opensolr username
  • HTTP password: your Opensolr password

Step 4: Set the Solr Path

Set the Solr path to /solr in Drupal. The Solr core field should be your Opensolr Index name.

Step 5: Upload Solr Config Files

Download the Solr configuration files from the Search API Solr module. You will find them in the conf directory of the module. Zip them up and upload them to your Opensolr Index via the Config Files Editor in the control panel.

Make sure you upload the config files that match your Drupal version and Solr version.

Step 6: Reload and Index

After uploading config files, click Reload in your Opensolr control panel. Then go back to Drupal and create your Search API index. Click Index now to start sending content.

Quick Checklist

  • Select Basic Auth in Drupal Solr server settings
  • Set simple credentials (no special characters) in Opensolr control panel
  • Enter the same credentials in Drupal
  • Set Solr path to /solr and core to your index name
  • Upload config files from Drupal to Opensolr
  • Reload the Opensolr Index after uploading

Need help with legacy Drupal setup? Reach out to us at support@opensolr.com — we handle Drupal configurations daily.