Parameter Reference

Cluster Parameters


Defaults to 1. The number of shards to hash documents to. There must be one leader per shard and each leader can have N replicas.

SolrCloud Instance Parameters

These are set in solr.xml, but by default the host and hostContext parameters are set up to also work with system properties.


Defaults to the first local host address found. If the wrong host address is found automatically, you can override the host address with this parameter.


Defaults to the port specified via bin/solr -p <port>, or 8983 if not specified. The port that Solr is running on. This value is only used when -DzkRun is specified without a value (see below), to calculate the default port on which embedded ZooKeeper will run. In the solr.xml shipped with Solr, the hostPort system property is not referenced, and so is ignored. If you want to run Solr on a non-default port, use bin/solr -p <port> rather than specifying -DhostPort.


Defaults to solr. The context path for the Solr web application.

SolrCloud Instance ZooKeeper Parameters


Defaults to localhost:<hostPort+1000>. Causes Solr to run an embedded version of ZooKeeper. Set to the address of ZooKeeper on this node; this allows us to know who you are in the list of addresses in the zkHost connect string. Use -DzkRun (with no value) to get the default value.


The host address for ZooKeeper. Usually this is a comma-separated list of addresses to each node in your ZooKeeper ensemble.


Defaults to 15000. The time a client is allowed to not talk to ZooKeeper before its session expires.

zkRun and zkHost are set up using system properties. zkClientTimeout is set up in solr.xml by default, but can also be set using a system property.

SolrCloud Core Parameters


Defaults to being automatically assigned based on numShards. Specifies which shard this core acts as a replica of. shard can be specified in the for each core.

Additional cloud related parameters are discussed in Format of solr.xml

Comments on this Page

We welcome feedback on Solr documentation. However, we cannot provide application support via comments. If you need help, please send a message to the Solr User mailing list.