Public | Automated Build

Last pushed: 3 months ago
Short Description
Set up a Solr 5.x instance in Docker, automatically configured with search_api_solr's settings.
Full Description


Set up a Solr 4.x instance in Docker, automatically configured with search_api_solr's settings.


  1. Clone the repository: git clone --recursive
  2. If you're using Kitematic 0.5.x or higher, go to File -> Open Docker Command Line Terminal and run the next command in the new terminal window, otherwise you'll get an error.
  3. Build an image: cd docker-solr-search_api_solr ; docker build -t solr-search_api_solr .


  1. Start a container from the image: docker run -P -d solr-search_api_solr
  2. Find the IP address and port for the Solr instance, so you can point Drupal's search_api_solr module to it:
    • If you're using Kitematic 0.5.x or higher, you can find the IP address and port to point to by clicking the container -> Settings -> Ports and looking at the Mac Port column. Note that clicking the link will (currently) bring you to a 404 page, because Kitematic doesn't know to add /solr/ to the URL.
    • If you're using just the command-line, take note of the instance ID returned by Usage Step #1 and run: docker inspect --format='{{.NetworkSettings}}' $INSTANCE_ID
  3. When creating a server in the Search API module, set:
    • Solr host = The IP address of the container (e.g.:
    • Solr port = The port of the container (e.g.: 34567)
    • Solr path = /solr/collection1

You can also access the Solr web interface by going to http://ip:port/solr (e.g.:


  • Solr automatically sets up a collection for you named collection1. If you want, you can add new collections from the Solr web interface, but I recommend starting a new container for a different project (e.g.: follow the usage steps again). Multiple containers can run simultaneously, they just get different port numbers.
  • If you delete a container, it's configuration and data will be deleted along with it! If using this on a production environment, make sure to set up Volumes and/or run containers to back up the data.
  • If you restart your computer or Kitematic, the port assigned to a container might change. If this happens, Search API will complain that it can't connect to the Solr instance. You'll have to go into the Search API server settings and change the port that way, or use the Search API Override module to put the settings in settings[.local].php, to make them easier to change:

      // Search API Override module.
      $conf['search_api_override_mode'] = 'load';
      $conf['search_api_override_servers'][$server_machine_name]['options'] = array(
        'host' => '',
        'port' => '34567',
        'path' => '/solr/collection1',
Docker Pull Command