The Problem
Your Drupal site cannot connect to your Opensolr Index. The Solr server shows as "unavailable" or you get connection errors when trying to index content.
Troubleshooting Checklist
1. Use the Latest Module
Make sure you are using the latest version of Search API Opensolr (for Drupal 8+). This module handles most connection setup automatically.
2. Select Basic Auth
In your Drupal Solr server settings, select "Solr with Basic Auth" or "Opensolr with Basic Auth" as the connection method. Opensolr requires authentication on all indexes.
3. Set Your Credentials
Enter the username and password from your Opensolr Index Control Panel. You can find these in the Security tab.
4. Use a Simple Password
This is the most common pitfall. Do not use special characters in your Opensolr username or password. Characters like @, #, &, % can cause URL encoding issues in Drupal's HTTP client.
If your current password has special characters, change it in the Security tab of your Opensolr control panel to something alphanumeric (e.g., mypassword123).
5. Upload Solr Config Files
Drupal provides a config zip that must be uploaded to your Opensolr Index. Go to the Config Files Editor in your control panel and upload the zip. Then click Reload.
6. Verify Connection Parameters
Double-check the hostname, port, and path from your Opensolr Index Control Panel dashboard. Make sure they match exactly what you entered in Drupal.
Quick Checklist
- Install the latest Search API Opensolr module
- Select Basic Auth in Drupal Solr server settings
- Enter the correct credentials from your Opensolr control panel
- Use a simple password — no special characters
- Upload config files from Drupal to Opensolr
- Verify the hostname matches your control panel dashboard
Still having connection issues? Reach out to us at support@opensolr.com — we will help you troubleshoot the connection directly.