Back to overview

Apache SOLR

Add it on-the-fly to your HumHub by activating it in the Modules menu! ("Administration -> Modules")

Apache SOLR Integration

Integrates Apache Solr software into the HumHub search subsystem.

Solr is highly reliable, scalable and fault tolerant, providing distributed indexing, replication and load-balanced querying, automated failover and recovery, centralized configuration and more. Solr powers the search and navigation features of many of the world's largest internet sites.

More information about Apache SOLR can be found here:


Apache Solr Installation

This guide covers only the basic installation and configuration steps of Apache Solr. More advanced configuration will be required, such as firewall security settings or individual performance tuning.

Note: This documentation was tested at last with Apache Solr 8.4.1 and should be compatible with all Apache Solr versions 8.0+.

  1. Install Apache Solr as described in the Solr manual.

    As quick start: Download Apache Solr and extract it to any folder (e.g. /opt/solr). After successfully extracting the file, Solr can be installed as a service in a Linux system by calling solr/bin/

  2. Start SOLR. e.g.

     cd /opt/solr
     ./bin/solr start
  3. Add a new core for HumHub. e.g.

     cd /opt/solr
     ./bin/solr create -c humhubcore
  4. Configure the core. Make sure that this step happens before the first use of the core.

    Stop the Solr Service:

     cd /opt/solr
     ./bin/solr stop

    Copy configuration provided by HumHub SOLR module.

      cd /opt/solr/server/solr/humhubcore/conf
      cp /path-to-humhub/protected/modules/solr/docs/schema.xml .
      cp /path-to-humhub/protected/modules/solr/docs/solrconfig.xml .  
      rm managed-schema
  5. Restart Apache Solr after this change!

     cd /opt/solr
     ./bin/solr restart

HumHub Configuration

  1. Make sure the Solr Search module is installed and enabled.

  2. Add following part into the components section of your configuration file protected/config/common.php.

     return [
         // ...
         'components' => [
             // ...
             'search' => [
                 'class' => 'humhub\modules\solr\engine\SolrSearch',
                 'host' => 'localhost',
                 'port' => 8983,
                 'path' => '/solr/humhubcore'
             // ...
         // ...

    More information about the individual configurations can be found here:

  3. Rebuild the search index.

     cd /path-to-humhub-here/protected
     php yii search/rebuild

1.1.1 (August 11, 2020)

  • Fix: Issue with multi valued groups user field

1.1.0 (February 8, 2020)

  • Enh: Improved documentation with sample schema and configuration
  • Enh: Fixed Solr 8.0ü compatiblity

1.0.0 (November 11, 2019)

  • Enh: Initial release of standalone version
1.1.1 (released 2 years ago)

HumHub GmbH & Co. KG


HumHub 1.4 - Latest

Professional Edition

This module is part of the Professional Edition.