The Complete Opensolr Platform Guide

Control Panel
Platform Guide
The Complete Opensolr Platform Guide
Everything you need to know about Opensolr — from creating your first Solr index to running a fully managed production search stack with AI-powered features, a built-in web crawler, and a complete REST API.

Managed Solr Hosting

Opensolr is a fully managed Apache Solr hosting platform. You get production-grade Solr clusters without managing servers, JVMs, or replication — we handle all of that.

Global Regions
US-East, US-West, EU-Central, EU-West, EU-North, Asia-Pacific — pick the region closest to your users.
Solr 5 through the latest Solr version available to date
Multiple Solr versions available. Upgrade at any time from the Control Panel.
Shared, Dedicated & Resilient
From free shared indexes to dedicated clusters with master + replicas for high-availability workloads.
HTTPS & Auth by Default
Every index comes with SSL encryption and HTTP Basic Auth. Add IP whitelisting for extra security.

Getting Started — Create Your First Index

SIGN UP
Create account
ADD NEW
Dashboard menu
SELECT REGION
Version + location
NAME + CREATE
Click Add Index
CONFIGURE
Upload schema, go!
From signup to live search in under five minutes

1. Create your account

Head to opensolr.com and click Sign Up. Enter your email, choose a password, and confirm via the activation email. Once logged in, you land on your Dashboard — the central hub for indexes, clusters, billing, team members, and API keys.

Opensolr Login

2. Open the Control Panel and click "Add New"

Click your username in the top-right corner, select Control Panel, then open My Indexes and click Add New.

Control Panel menu
Add New index

3. Choose your region and Solr version

Use the filter dropdowns to select a Region, Solr Version, and optionally a Country. Click the cluster card that matches your needs.

Select Region
Select Cluster

4. Name your index and create it

Give your index a meaningful name (e.g. my_website, product_search) or keep the auto-generated ID. Click Add Index — your index is provisioned in seconds with connection details, hostname, port, and credentials ready to use.

Name your index

5. Upload your configuration

Click your index name to enter its Index Control Panel, then go to Configuration. Edit config files live in the browser (schema.xml, solrconfig.xml, synonyms, stopwords) or upload a ready-made config zip for your CMS. Your index is now ready to receive data.

See Solr Configuration Files Dependency Flow for details on how config files work together.

Configuration Manager

The Opensolr Control Panel

A single web-based dashboard for managing every aspect of your Solr indexes — from live analytics and query monitoring to configuration, security, backups, and index tools.

Index Management
Create, delete, start, and stop indexes. Choose regions, Solr versions, and provision in seconds.
Schema & Config
Edit schema.xml, solrconfig.xml, synonyms, and stopwords directly in the browser — or upload a config zip.
Analytics & Monitoring
Query analytics with charts, bandwidth and disk usage, document counts, live query stream, and exportable PDF reports. Learn more
Security
HTTPS enforced by default. Manage HTTP Auth credentials, set up IP whitelisting, control per-index access. Learn more
Backup & Restore
One-click backups with instant restore, downloadable archives, and automated replication across regions. Learn more
Index Tools
Delete by query, reload, reset, commit, optimize, and restart Solr — all from the toolbar. Learn more
Team Management
Invite team members, assign roles, and manage shared access across all your indexes. Learn more
Query Interface
Run raw Solr queries directly from the panel. See real-time results, inspect response payloads, and debug without leaving the browser.
REST API Automation
Every action in the Control Panel is available via the REST API. Automate index creation, config uploads, backups, and more. See below
Opensolr Analytics Dashboard
Opensolr Index Overview

Connect Your Application

Drupal
Install Search API + Search API Opensolr. Add a server, enter your Opensolr hostname, port 443, path /solr/INDEX_NAME. Generate and upload the config set, create an index, and start indexing.
WordPress
Install WPSOLR or a similar Solr plugin. Enter your Opensolr host, port 443, path /solr/INDEX_NAME, and your auth credentials. Save and reindex.
Custom Application
Connect any app (PHP, Python, Node.js, Java, Ruby) directly to Solr's HTTP API with Basic Auth. Index via /update, query via /select. Supports JSON, XML, and CSV.
Moodle LMS
Connect Moodle's Global Search to Opensolr. Full integration tutorial covers setup, configuration, and troubleshooting.

Opensolr Web Crawler

Don't have an app backend or CMS? The Opensolr Web Crawler crawls any website and builds a fully indexed, searchable site — no code, no plugins, no infrastructure to manage.

Headless Chromium Rendering
Built-in Playwright-powered browser renders JavaScript-heavy pages — SPAs, React, Angular, Vue — no content left behind.
Multi-Format Extraction
Extracts content from HTML, PDF, DOCX, ODT, and XLSX files. Every page gets clean, structured text for indexing.
NLP Enrichment
Every crawled page is enriched with sentiment analysis (VADER), language detection, and price extraction from meta tags, JSON-LD, and microdata.
Embeddable Search UI
Add search to your site with two lines of HTML — or build a custom UI with the Solr API. Dark mode, scroll pagination, and more.
Search Analytics
Track what users search for, click-through rates, no-results queries, and content gaps — all built in.
Query Elevation
Pin pages to the top or exclude irrelevant results for specific queries. Full curation control from the dashboard.

App Server Management

Beyond Solr hosting, Opensolr manages your entire application stack — Drupal, Laravel, WordPress, or any framework running on your own servers or ours.

24/7 Monitoring & Auto-Healing
Watchdog service checks every server every 5 seconds. If a service goes down, it's automatically restarted before you notice.
Full Stack Support
Apache, Nginx, PHP-FPM, MySQL, Redis, Memcached, HAProxy, SSL certificates — we manage the entire stack so you can focus on your application.
Git CI/CD & DR Environments
Git-based deployments, staging environments, disaster recovery setups — enterprise-grade DevOps without the overhead.

Drupal Modules — Opensolr Turbo Indexer

Opensolr actively contributes to the Drupal ecosystem. Our flagship Drupal module is the Opensolr Turbo Indexer — a Drush-based parallel indexing engine that dramatically speeds up Solr indexing for large Drupal sites.

Parallel Batch Indexing
Run multiple indexing workers simultaneously. Index hundreds of thousands of documents in a fraction of the time it would take with standard Drupal cron.
Drush Integration
Simple Drush commands: drush ost --workers=3 --batch=100 for turbo parallel indexing, drush oss for stats, drush osstop to halt.
Background & Scheduled
Run indexing in the background with drush ost --background. Schedule via cron for fully automated, hands-free reindexing.

We also maintain the Search API Opensolr connector module, which simplifies connecting Drupal's Search API to any Opensolr-hosted index.


AI-Powered Search

Opensolr offers built-in AI search capabilities that go beyond traditional keyword matching.

Hybrid Search
Combines traditional keyword search with vector-based semantic search for results that understand meaning, not just words. Learn more
Vector Embeddings
Generate 1024-dimensional embeddings with BGE-m3 for any document. Single-doc and batch APIs available. Learn more
Search Tuning
Per-index relevancy controls — adjust field weights, boosting, and ranking strategies to fine-tune search quality. Learn more

REST API — Automate Everything

Every operation in the Opensolr Control Panel is available through the REST API. Automate index provisioning, config management, security, backups, crawling, and monitoring programmatically.

Quick API Examples

Once your index is live, interact with it directly via HTTP. Replace USER:PASS with your index credentials and CLUSTER.opensolr.com with your cluster hostname.

Search:

curl -u USER:PASS "https://CLUSTER.opensolr.com/solr/INDEX_NAME/select?q=laptop&rows=10&wt=json"

Index a document:

curl -u USER:PASS "https://CLUSTER.opensolr.com/solr/INDEX_NAME/update?commit=true" \
  -H "Content-Type: application/json" \
  -d '[{"id":"1","title":"My First Document","content":"Hello Solr!"}]'

PHP:

$url = 'https://CLUSTER.opensolr.com/solr/INDEX_NAME/select?q=laptop&wt=json';
$context = stream_context_create(['http' => [
    'header' => 'Authorization: Basic ' . base64_encode('USER:PASS')
]]);
$response = file_get_contents($url, false, $context);
$data = json_decode($response, true);
print_r($data['response']['docs']);

JavaScript:

const response = await fetch(
  'https://CLUSTER.opensolr.com/solr/INDEX_NAME/select?q=laptop&wt=json',
  { headers: { 'Authorization': 'Basic ' + btoa('USER:PASS') } }
);
const data = await response.json();
console.log(data.response.docs);

For a complete reference of all search parameters, see Querying the Solr API: Search Parameters Explained.


Troubleshooting

Issue Likely Cause Fix
Can't connect to Solr Wrong hostname, port, or credentials Check your Index Control Panel for the correct URL. Use port 443 for HTTPS.
No search results Content not indexed or schema mismatch Reindex your content. Ensure schema fields match what your app sends.
Drupal: "Server could not be reached" Config set not uploaded or wrong Solr version Upload the config set from Search API Solr. Check Solr version matches.
WordPress plugin error Plugin version incompatibility Update WPSOLR. Verify connection details.
Slow queries Unoptimized index or expensive queries Run Optimize from Tools, check Query Debugging.

Explore More


Ready to get started?
Sign up for free and have your first Solr index running in minutes.